agora-mcp-server
v0.2.1
Published
MCP server for Agora's open agent-commerce protocol. Search 22.5k+ products across 52 stores, build carts, and run consumer-approved checkouts. Stdio transport. Compatible with Claude Desktop, Cursor, ChatGPT.
Maintainers
Readme
agora-mcp-server
MCP server for Agora — the open protocol for agent commerce. Lets any MCP-compatible AI agent (Claude, ChatGPT, Cursor) search products, build carts, and run consumer-approved checkouts across the Agora network.
22,500+ products indexed across 52 stores · Protocol v1.0 · MIT licensed.
Install
Add to your MCP host config (Claude Desktop / Cursor / etc.):
{
"mcpServers": {
"agora": {
"command": "npx",
"args": ["agora-mcp-server"],
"env": {
"AGORA_API_KEY": "ak_your_key",
"AGORA_CONSUMER_ID": "your_consumer_id"
}
}
}
}AGORA_API_KEY is required. AGORA_CONSUMER_ID is optional (defaults to "default") — set it if you want all your carts/orders linked to a stable consumer record.
Get an API key at agora-portal.vercel.app.
Tools exposed
Discovery
| Tool | Description |
|---|---|
| agora_search | Search products by natural-language query. Optional filters: source, minPrice, maxPrice, availability. |
| agora_product | Fetch a single product by Agora ID (e.g. agr_abc123). |
| agora_similar | Find products similar to a given product. |
Cart
| Tool | Description |
|---|---|
| agora_cart_create | Create a new cart for a consumer. |
| agora_cart_view | View a cart with items and subtotal. |
| agora_cart_add | Add a product to a cart. |
| agora_cart_remove | Remove an item from a cart. |
Checkout
| Tool | Description |
|---|---|
| agora_checkout_create | Begin a checkout. Returns an approval URL the human must visit to authorize the purchase. The agent never charges a card without explicit consumer consent. |
| agora_checkout_approve | Approve a pending checkout with the token. Use only when the consumer has explicitly said yes in-conversation. |
| agora_checkout_deny | Deny a pending checkout. No charge is made. |
| agora_checkout_status | Poll a checkout's status (pending / completed / denied / expired). |
Orders
| Tool | Description |
|---|---|
| agora_order_get | Fetch a completed order by ID with line items. |
Consent model
Every purchase requires explicit consumer approval. The agent never sees a card and cannot complete a charge unilaterally:
- Agent calls
agora_checkout_createfrom a cart. - Agora returns a single-use, 15-minute approval token and a human-facing approval URL.
- Agent shows the URL to the consumer, who clicks through and approves on a real web page.
- Agent polls
agora_checkout_statusuntil status iscompleted(ordenied/expired). - On completion, the agent can fetch order details with
agora_order_get.
Tokens are timing-safe-compared on the server. Expired tokens cannot be revived.
Transport
Stdio only. Speaks the Model Context Protocol over stdin/stdout. Compatible with Claude Desktop, Cursor, and any other MCP host.
License
MIT.
Built by Bento Labs · Protocol spec · Live API
