> ## 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 Overview

> Connect AgentCard to your AI agent via MCP

The AgentCard MCP server gives your AI agent tools to manage virtual cards, pay for things, and shop — authenticated with your own OAuth login. It's the recommended way to use AgentCard from Claude Code, Cursor, Claude Desktop, and other MCP clients.

* **Endpoint:** `https://mcp.agentcard.sh/mcp`
* **Transport:** Streamable HTTP
* **Auth:** OAuth 2.0 — sign in with your AgentCard account; no API keys

## Quick connect (Claude Code)

The CLI configures everything in one step:

```bash theme={null}
npm install -g agent-cards
agent-cards signup        # approve the sign-in in your browser
agent-cards setup-mcp     # add the MCP server to Claude Code
```

Then **restart your Claude Code session** so the tools load.

To add it manually instead:

```bash theme={null}
claude mcp add --transport http agent-cards https://mcp.agentcard.sh/mcp
```

## Other clients

<Tabs>
  <Tab title="Cursor / Windsurf">
    Add to the agent's MCP config (`.cursor/mcp.json`, `.windsurf/mcp.json`, etc.):

    ```json theme={null}
    {
      "mcpServers": {
        "agent-cards": {
          "url": "https://mcp.agentcard.sh/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude.ai (web)">
    1. Open **Settings → Integrations**.
    2. Click **Add Integration**.
    3. Enter `https://mcp.agentcard.sh/mcp`.
    4. OAuth handles authentication automatically.
  </Tab>

  <Tab title="Claude Desktop">
    Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "agent-cards": {
          "url": "https://mcp.agentcard.sh/mcp"
        }
      }
    }
    ```
  </Tab>
</Tabs>

<Note>
  After connecting, restart your agent session before expecting the tools to appear. The first tool call triggers the OAuth sign-in flow in your browser.
</Note>

## First steps in your agent

Once connected, your agent can call `get_instructions` for the current usage guide, then `list_cards` to orient. Creating the first card walks through funding the wallet and one-time KYC — see [KYC & approvals](/personal/kyc-and-approvals). The full tool catalog is in the [Tools reference](/personal/mcp/tools).