MCP integration

Connect Claude and other MCP clients to BuyVerse.ai. The MCP server calls the same gateway routes as the REST API and signs in with a scoped API key.

Authentication

Each tool calls the gateway with your machine API key (X-API-Key) and its key ID (X-API-Key-ID). The key's business scopes every tool, so there is no separate MCP credential.

Connect a client

Add the BuyVerse.ai server to your client's configuration (for Claude Desktop, claude_desktop_config.json), then restart the client. The BuyVerse.ai tools appear in the assistant's tool list.

claude_desktop_config.json

{
  "mcpServers": {
    "buyverse": {
      "command": "npx",
      "args": ["-y", "@buyverse/mcp-server"],
      "env": {
        "BUYVERSE_API_KEY": "YOUR_API_KEY",
        "BUYVERSE_API_URL": "https://api.buyverse.ai/api/v1",
        "EXTERNAL_AGENT_ID": "your-agent-id"
      }
    }
  }
}

Available tools

Read and action tools backed by the product, order, trust, finance and agent services. A selection is below; a connected client lists the full set.

query_buyverse
Natural-language query to the BuyVerse.ai assistant: search products and services, discover suppliers, or find the best match.
search_products
Search products across the network with optional category and price filters.
get_product
Get full detail for one product — variants, pricing, and images.
check_availability
Check in-stock availability of a product (or a specific variant) for a business.
get_business
Get a business profile, product count, and trust score.
list_deals
List currently active deals and promotions.
create_order
Place a new order for products with customer details and line items.
get_order_status
Get the current status and details of an order.
get_trust_score
Get the trust score and reputation breakdown for a business.
get_relationship_trust
Buyer/seller relationship trust snapshot between two businesses.
get_verification_status
Verified-badge and verification status for a business.
get_agent_reputation
Reputation snapshot for an agent in the network.