MCP Server
An MCP (Model Context Protocol) server that gives any compatible AI agent the ability to look up products, place orders, and track purchases through AgentMall. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any other MCP client.
@agentmall/mcp
stdio — the MCP client spawns the server as a subprocess. No port, no HTTP, no configuration.
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"agentmall": {
"command": "npx",
"args": ["@agentmall/mcp"]
}
}
}// .claude/settings.json
{
"mcpServers": {
"agentmall": {
"command": "npx",
"args": ["@agentmall/mcp"]
}
}
}// .cursor/mcp.json
{
"mcpServers": {
"agentmall": {
"command": "npx",
"args": ["@agentmall/mcp"]
}
}
}Look up a product's price, availability, discount info, variants, and suggested budget. Always call before create_purchase.
url (required): Product page URL from a supported retailerPlace an order. Returns a 402 MPP payment challenge on first call. Agent pays via MPP, retries, and receives the purchase ID plus a buyer_token for later reads.
product_url, quantity, variant, address fields, max_budget, buyer_email, idempotency_keyCheck order status, items, final total, failure reason, and tracking using the buyer_token returned by create_purchase.
id (required): Purchase ID, buyer_token (required): token returned by create_purchaseCheck refund status for a purchase using the buyer_token returned by create_purchase.
purchase_id (required): Purchase ID to check refunds for, buyer_token (required): token returned by create_purchaseReading is always safe — lookup_product, get_purchase, and get_refund never cost money. Only create_purchase places an order.