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 # click the magic link in your email
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 saving a payment method and one-time KYC — see KYC & approvals. The full tool catalog is in the Tools reference.