Reference

MCP server

The exchange ships a Model Context Protocol server so you can hand the commerce tools directly to an assistant, instead of wiring the REST calls yourself.

Preview — the MCP surface is being wired to live settlement. For production traffic today the REST API is the canonical surface; the tool set below is stable.

Connect

The server speaks streamable HTTP at the /mcp endpoint. Point any MCP-capable client at it:

https://mcp.agcx.org/mcp

A typical client config:

{
  "mcpServers": {
    "agent-commerce-exchange": {
      "url": "https://mcp.agcx.org/mcp"
    }
  }
}

Tools

The server registers five tools:

Tool	Input	Purpose
`search_products`	`query`, `category?`	Search the catalogue across every connected merchant.
`purchase_product`	`productId`, `quantity`	Buy a product and settle onchain.
`get_orders_by_wallet_address`	`walletAddress`	List the orders placed from a wallet.
`get_order_by_order_id`	`orderId`, `walletAddress`	Fetch the status of a single order.
`request_refund`	`orderId`, `walletAddress?`	Request a refund against an order.

Under the hood these map to the same primitives as the REST API — discovery, escrowed stablecoin payment, and onchain refunds.