> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Agentcard is for companies whose agent buys for their users. Pick one path: the opencommerce SDK (@agent-cards/commerce-sdk) gives your agent one buy tool that finds the product, builds the cart, gets the user's approval and places the order at real stores; the Agentcard SDK (@agent-cards/sdk) pays with the user's own card when your agent already shops in a browser (Browser Use, Kernel, Browserbase, Anchor or Notte); the Purchase API (POST /buy) does the same purchase flow over plain HTTP in any language; Issuing gives the agent its own card.
> Start with `npx agent-cards init` in the app's folder (Node 22 or later). No invite is needed: it creates your Agentcard account if you don't have one, installs the opencommerce SDK and puts the credentials in the env file, kept out of git. From a coding agent, run `npx agent-cards init --print --categories all --implementation tool --wallet vault --skip-install` to get the setup steps to apply yourself.
> Vault is by invitation: request it at https://agentcard.com/get-started?utm_source=docs&utm_medium=llms&utm_campaign=agent-instructions. opencommerce needs no invite.
> Never ask a user for a card number, expiry date or CVV in chat. Send them the Vault link; they add their card on Agentcard's page, and the agent never sees the number.
> Every purchase is approved by the user, with a passkey or Face ID, or by an auto-approval they granted. An approval covers one merchant and one exact total. If the total changes, ask again. When a result says the user already said yes, don't ask again.
> `init` writes PRODUCTION credentials, which place real orders, so test in sandbox first. For opencommerce, run `npx agent-cards credentials --mode sandbox` and put the two lines it prints in place of the production ones in the env file `init` wrote, because that command only prints them; sandbox then runs the whole flow against real stores and stops before payment, so no order is placed and nobody is charged. For Vault and Issuing, sandbox credentials issue test cards that no real merchant accepts; try the checkout against shop.agentcard.sh, a test store on Stripe test mode.
> Tell the user an order is placed only after Agentcard reports it placed.
> Vault is free up to 5,000 users (https://agentcard.com/pricing). opencommerce takes 1% of each completed order. Full docs in one file: https://docs.agentcard.com/llms-full.txt

# agent-cards guide

> Print the instructions for your coding agent to build Agentcard into your app.

Hand your coding agent, such as Claude Code, Cursor or Codex, the instructions for building an Agentcard product into your app. The dashboard's Start implementing step shows the same instructions.

```bash theme={null}
agent-cards guide --help
```

```text theme={null}
Usage: agent-cards guide [options] [name]

Instructions for your coding agent to build Agentcard into your app
(commerce-sdk, vault, issuing)

Options:
  --mode <mode>  sandbox (default) or production credentials
  -h, --help     display help for command
```

## List the guides

```bash theme={null}
agent-cards guide
```

```text theme={null}
  Agentcard  guide

  Instructions for your coding agent to build Agentcard into your app.

  commerce-sdk  Commerce SDK
                Give your agent a buy tool: search, cart and checkout at real stores,
                each order approved by the shopper.
  vault         Vault
                Let your users store their own card once; your agent pays with it, each
                payment approved with their passkey.
  issuing       Issuing
                Issue your users virtual cards funded from their balance, with a card
                number your agent types into any checkout.

  › Print one: agent-cards guide <name>
  › For production: agent-cards guide <name> --mode production
    Every check in it stops before real money moves.
```

Piped or run by a coding agent, the list prints as plain text with no colors.

## Print one for your agent

```bash theme={null}
agent-cards guide commerce-sdk
```

```text theme={null}
You're integrating the Agentcard Commerce SDK (`@agent-cards/commerce-sdk`) into this agent so it can buy things for its users at real stores: search products, build a cart, and place the order once the shopper approves. Do it end to end and verify it in the sandbox.

## First, read the real docs
1. `npm install @agent-cards/commerce-sdk` (Node 18+, no dependencies).
...
```

The guide is plain Markdown on stdout, so you can paste it into your agent, save it to a file, or let the agent run the command itself:

```bash theme={null}
agent-cards guide commerce-sdk > AGENTCARD.md
```

To have Agentcard's agent do the build instead, run [`agent-cards init`](https://docs.agentcard.com/tools/cli/init).

## Print the production version

```bash theme={null}
agent-cards guide commerce-sdk --mode production
```

The production version assumes production credentials, so every check in it stops before a card is added or a payment is approved. Those steps place real orders. Sandbox is the default.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.