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

# MCP

> One MCP server for everything: manage your organization from your coding agent, and give your users' agents a way to buy.

## Install the Agentcard MCP

```bash theme={null}
npx -y agent-cards setup-mcp
```

One command. A browser sign-in appears the first time a tool runs, and new emails get an account on the spot. If you don't use Claude Code, it prints the server URL to add in any MCP client.

There is one Agentcard MCP server, at `https://mcp.agentcard.sh/mcp`. What it exposes depends on the credential you connect with: your own account, your organization, or one of your users.

## Connect as your organization

You can run your whole Agentcard integration without leaving your coding agent. Connect with the same credentials you use for the API:

```bash theme={null}
claude mcp add agentcard --transport http https://mcp.agentcard.sh/mcp \
  --header "Authorization: Bearer YOUR_CLIENT_SECRET"
```

That works in any MCP client. For Cursor or Claude Desktop, add the same URL and header to your MCP config.

Whether you get sandbox or production is decided by the credential you connect with, like everywhere else.

## What your agent can do with it

22 tools, the same operations as the API. Your agent can build the integration, test it, and debug it in production.

| Area            | Tools                                                                                                                |
| --------------- | -------------------------------------------------------------------------------------------------------------------- |
| Users           | `create_cardholder` · `list_cardholders` · `get_cardholder` · `create_onboarding_session` · `get_onboarding_session` |
| Identity        | `start_cardholder_kyc` · `get_cardholder_kyc_status`                                                                 |
| Cards           | `create_card` · `list_cards` · `get_card` · `get_card_details` · `close_card`                                        |
| Payment methods | `setup_cardholder_payment_method` · `get_cardholder_payment_method_status`                                           |
| Company balance | `get_company_wallet` · `list_transfers` · `confirm_collection` · `recover_funds` · `list_recoveries`                 |
| Testing         | `test_charge` (simulates a full charge in sandbox: authorization, settlement, webhooks)                              |
| Session         | `whoami` · `mint_buy_token`                                                                                          |

When something breaks during your integration, connect this server and ask your agent to debug it. It can read the same state we see.

## Give your users' agents a way to buy

The organization server is for you. Your users' agents connect to a different server, as the user.

Create a buy token for a user with `mint_buy_token` (or `POST /api/v1/cardholders/:id/buy_token`). It lasts 30 days and only works for that one user. The agent then connects with it:

```bash theme={null}
claude mcp add agentcard-user --transport http https://mcp.agentcard.sh/mcp \
  --header "Authorization: Bearer BUY_TOKEN"
```

That agent gets the user's tools, and the one that matters is `buy`. The whole story is on the [Purchase API](/purchase/purchase-api) page.

Next: [Test in sandbox](/ship/test-in-sandbox)