Skip to content

Connect via MCP

Add the AiVironment Marketplace as a tool source to your AI client. Once connected, the model can search the directory, read company profiles, and submit quote requests on your behalf — no scraping, no HTML parsing.

New here? Read the guide first to understand what the marketplace is and what you can do with it.

Get a token

The MCP endpoint requires a Bearer token. Generate one yourself in seconds:

  1. Sign in (Google, or email if dev-login is enabled).
  2. Open Dashboard → MCP tokens, click Create token, name it, pick scopes, and choose an expiration.
  3. Copy the value (starts with aiv_mcp_…) — it's shown only once.
  4. Paste it in place of YOUR_MCP_TOKEN in any snippet below. Revoke any time from the same page.

Need help or want a higher rate limit? pmagdanski@qasttor.com.

Claude Code

Anthropic's CLI. Easiest to wire up — one command and the tools appear next time you open a session.

Option A — CLI

bash
claude mcp add aivironment-marketplace \
  --transport http \
  https://mcp.marketplace.aivironment.ai/mcp \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Option B — edit config directly

Add this to ~/.claude.json (or use /mcp inside Claude Code):

json
{
  "mcpServers": {
    "aivironment-marketplace": {
      "type": "http",
      "url": "https://mcp.marketplace.aivironment.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Claude Desktop

The macOS / Windows app. Recent versions support HTTP transport directly; older versions need a stdio bridge.

Recent versions (HTTP transport)

Same JSON shape as Claude Code, in claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{
  "mcpServers": {
    "aivironment-marketplace": {
      "type": "http",
      "url": "https://mcp.marketplace.aivironment.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

Older versions (stdio bridge via mcp-remote)

If your Claude Desktop only speaks stdio, wrap the HTTP endpoint with mcp-remote:

json
{
  "mcpServers": {
    "aivironment-marketplace": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.marketplace.aivironment.ai/mcp",
        "--header",
        "Authorization: Bearer YOUR_MCP_TOKEN"
      ]
    }
  }
}

Claude.ai (web)

Pro, Team, and Enterprise plans support custom MCP connectors via the web UI.

  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Set the URL to:
    https://mcp.marketplace.aivironment.ai/mcp
  4. Add a custom header named Authorization with value Bearer YOUR_MCP_TOKEN.
  5. Save. The three tools appear in the connector list and become callable in any new conversation.

ChatGPT

MCP support is available on Pro, Business, and Enterprise plans.

  1. Open Settings → Connectors → Add MCP server.
  2. URL:
    https://mcp.marketplace.aivironment.ai/mcp
  3. Authentication: Bearer token. Paste your key.

REST fallback

If your runtime doesn't speak MCP, the same data is exposed over plain HTTP. No auth required for read-only endpoints; quote-request submissions are rate-limited per email.

bash
curl "https://api.marketplace.aivironment.ai/api/v1/search?q=industrial+robotics&country_code=DE"
  • 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
  • POST /api/v1/quote-requests — submit a quote request

Available tools

marketplace_search_companies(query?, country_code?, industry_code?, certification?, page?, per_page?)

Search the directory by natural-language query and structured filters. Returns ranked companies with location, industry, verification status, and certifications.

marketplace_get_company(slug)

Fetch a complete profile — description, offerings, public contact methods, review summary.

marketplace_request_quote(company_id, requester_name, requester_email, message, requester_company?, budget_label?)

Submit a quote request on behalf of your user. Rate-limited to 5 per hour per (company, requester_email) pair.

Typical workflow

  1. marketplace_search_companies(query="…") → pick candidates
  2. marketplace_get_company(slug="…") → read full profile, verify fit
  3. marketplace_request_quote(company_id="…", …) → hand off contact