Skip to main content
Agent connects to AgentMall server via MCP over streamable HTTP The MCP server is a streamable HTTP endpoint at mcp.getagentmall.com. AI agents connect here to search, cart, and check out.

Protocol

MCP over streamable HTTP. Any client that speaks the Model Context Protocol can connect.

URL

Authentication

Every tool call needs an organization API key.
The URL also accepts ?key=<key> as a query parameter. Prefer the header so the key stays out of logs and shared configs.

Connecting

Claude Code

Cursor

Add to ~/.cursor/mcp.json:

Other MCP clients

Point a streamable HTTP transport at https://mcp.getagentmall.com with an Authorization: Bearer <key> header. Or use the URL with the key inline:

Tools

All inputs are snake_case. Prices and totals are integer minor units of the merchant’s currency (cents for USD, pence for GBP). Call list_merchants for the nine live merchant ids.

Catalog

Cart

Sign-in

Checkout

Order

Errors

Every error is a JSON object with error.code and error.message:
Error codes are the same on MCP and REST. See Error codes for the full list.

Full tool reference

Input schemas, return shapes, and per-tool error codes are on MCP tools.