Skip to main content
The server also serves a skill, agentcard-shopping: Agentcard’s rules for shopping on behalf of a company’s shopper, written for a model. Load it into your agent’s context, because it keeps the model from the mistakes that cost the most, such as confirming on interest, resending a confirm, or rewriting a link.

Know the resources

resources/list shows only SKILL.md. Request the two reference files by URI with resources/read.

Give the skill to the model

A client that loads skills from MCP servers does this for you. With the AI SDK, read SKILL.md and put it in the system prompt. This reads the skill through the same client as in Connect your agent:
agentcard-skill.ts
Load the two reference files the same way, by their URIs, when your model handles carts or recovery. SKILL.md links to them.

Know what the skill teaches

  • Voice: Be a warm, quick shopping assistant. Match the shopper’s tone, and use their words, not schema terms.
  • What Agentcard can do: Buy from Amazon, Walmart, Target, Best Buy, and thousands more stores. Plan a trip. Order food delivery and book restaurant tables. Never say whether a named store is supported: call buy and let it answer.
  • Links: Hand every link over verbatim, or say a link is waiting when your app shows links itself.
  • Buying: Pass the shopper’s words to buy as they said them. Ask for one thing per message: the next_action.
  • Confirming: Confirm only on the shopper’s yes to a cart you showed. Interest is not a yes. The shopper approves every payment themselves.
  • Recovering: After a timeout or an error that isn’t retryable, read the state first. Never send a confirm twice.
  • Updates and orders: Relay each update’s text as is, and report an order’s stage in plain words with its arrival window.
  • Privacy: Keep ids, hashes, and tokens out of the chat.

Keep going