MCP Overview

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:

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:

claude mcp add --transport http agent-cards https://mcp.agentcard.sh/mcp

Other clients

Cursor / Windsurf
Claude.ai (web)
Claude Desktop

Add to the agent’s MCP config (.cursor/mcp.json, .windsurf/mcp.json, etc.):

{
  "mcpServers": {
    "agent-cards": {
      "url": "https://mcp.agentcard.sh/mcp"
    }
  }
}

Open Settings → Integrations.
Click Add Integration.
Enter https://mcp.agentcard.sh/mcp.
OAuth handles authentication automatically.

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agent-cards": {
      "url": "https://mcp.agentcard.sh/mcp"
    }
  }
}

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.

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. The full tool catalog is in the Tools reference.

Get Started

CLI

MCP

Guides

Concepts

Quick connect (Claude Code)

Other clients

First steps in your agent

​Quick connect (Claude Code)

​Other clients

​First steps in your agent

Quick connect (Claude Code)

Other clients

First steps in your agent