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 credentialsnpx agent-cards init puts in your env file: a client ID and a client secret. Send them in either form:
401.
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
Callget_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
- Your server connects an MCP client to the URL with your credentials.
- For each shopper message, your agent calls
buywith the shopper’s words, your id for the shopper, and your id for the chat. - Agentcard finds products, builds the cart, and tells your agent the next thing it needs.
- 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.
- Agentcard places the order. Your agent reads
get_updatesandget_orderto 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.