# AiVironment Marketplace

> An AI-native B2B marketplace built for AI agents. Companies list their profile, offerings, and contact methods. Agents discover them via an MCP server and can submit quote requests directly.

## What this is

The AiVironment Marketplace is a directory of verified B2B companies — suppliers, manufacturers, service providers, consultancies — indexed for discovery by autonomous AI agents acting on behalf of human buyers.

**Primary interface:** an MCP server hosted on the AiVironment Marketplace API (FastAPI on Cloud Run). Agents connect, search, read profiles, and submit quote requests through standardized MCP tools.

**Secondary interface:** a public web UI at marketplace.aivironment.com. The home page is a marketing landing for companies considering listing. The `/search` and `/company/{slug}` pages exist so humans can browse and so company profiles are shareable links, but the directory is designed for agent-first access.

## MCP server

Endpoint: `https://marketplace-api.aivironment.com/mcp` (Streamable HTTP transport)
Authentication: `Authorization: Bearer <MCP_API_KEY>` (contact hello@aivironment.com for access)

Available tools:

### marketplace_search_companies
Search the directory by natural-language query and optional structured filters.

Inputs:
- `query` (text, optional): natural language or keyword — e.g. "hydraulic valve manufacturer", "crane services", "AI integration"
- `country_code` (text, optional): ISO 3166-1 alpha-2 — e.g. "DE", "PL", "FR", "GB", "US"
- `industry_code` (text, optional): industry classification — e.g. "manufacturing", "consulting", "logistics"
- `certification` (text, optional): certification filter — e.g. "ISO 9001", "ISO 14001", "CE Mark"
- `page` (int, optional, default 1)
- `per_page` (int, optional, default 10, max 20)

Returns a ranked list of companies with name, location, industry, verification status, and certifications. Premium listings appear first.

### marketplace_get_company
Fetch a full company profile by slug. Use this after `marketplace_search_companies` to retrieve complete details for a specific result.

Inputs:
- `slug` (text, required): URL-friendly identifier from search results

Returns company description, all products and services, public contact methods (email, phone, website, MCP endpoint, or agent DID), and a review count.

### marketplace_request_quote
Submit a quote or contact request to a listed company on behalf of your user.

Inputs:
- `company_id` (uuid, required): from search results
- `requester_name` (text, required): the requester or agent identifier
- `requester_email` (text, required): where the company should reply
- `requester_company` (text, optional): the requester's company
- `message` (text, required): describe what is needed — be specific about quantities, specs, timeline
- `budget_label` (text, optional): approximate budget — e.g. "€10k–€50k", "Under $5k", "Open to quotes"

The company is notified and will respond directly to the email provided.

## Typical agent workflow

1. `marketplace_search_companies(query="...", country_code="...", certification="...")` → pick one or more candidates
2. `marketplace_get_company(slug="...")` → read full profile, verify fit
3. `marketplace_request_quote(company_id="...", requester_name="...", requester_email="...", message="...")` → hand off contact

## Machine-readable endpoints (fallback for non-MCP clients)

If your runtime doesn't speak MCP, these REST endpoints serve the same data. Base URL: `https://marketplace-api.aivironment.com`

- `GET /api/v1/search` — keyword + filter search
- `GET /api/v1/companies/{slug}` — single company profile
- `GET /api/v1/companies/featured` — curated listings
- `GET /api/v1/categories` — industry taxonomy for browsing
- `POST /api/v1/quote-requests` — submit a quote request
- `GET /api/v1/companies/{slug}/reviews` — paginated reviews

## Public pages (human-readable)

- `/` — marketing landing
- `/search` — faceted directory browse (humans; agents should use MCP)
- `/company/{slug}` — shareable company profile pages with JSON-LD structured data (`schema.org/Organization` with `makesOffer`, `contactPoint`, `aggregateRating`)
- `/sitemap.xml` — all company slugs

## Verification and trust

- Companies with the verified badge have been validated by the AiVironment team
- Premium listings appear first in search results
- Reviews have three verification tiers: `unverified`, `email_verified`, `customer_verified`
- Certifications are self-declared and admin-moderated