Skip to main content
The Agentcard Commerce MCP server is the Commerce SDK behind one URL. Your company’s agent connects to https://mcp.opencommerce.sh/mcp with your credentials, and it can search for products, build carts, get each shopper’s approval, place orders, and follow them to delivery for your shoppers. You install nothing and write no SDK code. No model runs on the server: your agent calls the tools, and Agentcard does the shopping.
If your agent runs in TypeScript and you want to control how each reply and link is shown, use the SDK instead: see the Commerce SDK quickstart. To call the same purchase flow from any other language over plain HTTP, see Buy over HTTP.

Know the endpoint

Authenticate with your Commerce SDK credentials

Use the credentials npx agent-cards init puts in your env file: a client ID and a client secret. Send them in either form:
A request with no credentials, or with credentials Agentcard refuses, gets 401.
Keep the client secret on your server. Don’t put it in a browser, a mobile app, or a prompt, because anyone who holds it can shop as your company.

Choose sandbox or production

Sandbox or production follows the credentials you send. Sandbox credentials reach the sandbox, where nothing is charged and stores decline at checkout. Production credentials reach live stores and place real orders. Test with sandbox credentials first, and switch by changing the credentials only: the URL and the tools stay the same.

Check the connection

Call get_account to confirm which company the credentials belong to and whether they are sandbox ones. It returns client_id and sandbox.

See how it works

  1. Your server connects an MCP client to the URL with your credentials.
  2. For each shopper message, your agent calls buy with the shopper’s words, your id for the shopper, and your id for the chat.
  3. Agentcard finds products, builds the cart, and tells your agent the next thing it needs.
  4. The shopper adds a card and approves the payment in a browser, on pages Agentcard hosts. Your agent hands over the links and can never approve for them.
  5. Agentcard places the order. Your agent reads get_updates and get_order to follow it.

Choose where to go next

Connect your agent

Connect a client, set the shopper and chat ids, and run a purchase from ask to delivery.

Tools

Every tool has its own page, with its arguments and what it returns, grouped by what it does.

The shopping skill

Load Agentcard’s rules for a model into your agent’s context.

Commerce SDK quickstart

Build the same flow in TypeScript, with full control over each reply.