MCP

Connect your agent to Cardia over MCP.

Claude, Cursor or ChatGPT create and operate cards on their own — always within the scope you define. You talk in natural language, Cardia executes, and the authorizer decides.

bash

$ claude mcp add --transport http cardia https://cardia.digital/api/mcp --header "Authorization: Bearer <your-token>"

One line in Claude Code and you're set: the hosted MCP is live in production. Each client uses ITS OWN token in the Authorization header.

claude

> Create a $25 card for my OpenAI subscription

● create_card (amount 25, currency USD)

● grant (merchant OpenAI, max 25, ttl 30d)

✓ Card ready: •••• 3119 · $25 USD · scope OpenAI

> Pay the subscription

● authorize_payment (merchant OpenAI, amount 20)

✓ APPROVED · OpenAI · $20 USD

> Now pay $300 at Steam

● authorize_payment (merchant Steam, amount 300)

✗ REJECTED · no grant for Steam ▋

Option 1 — Hosted MCP (HTTP)

The MCP server lives at https://cardia.digital/api/mcp. Nothing to install: point your client there and authenticate with your token in the Authorization: Bearer header. The token is never stored on the server — it travels per request.

Don't have an account or a token yet? Create your account →

URLhttps://cardia.digital/api/mcp

HeaderAuthorization: Bearer <your-token>

For clients that support MCP over HTTP (Cursor, Claude Desktop, etc.), paste this into the config:

mcp.json

{
  "mcpServers": {
    "cardia": {
      "type": "http",
      "url": "https://cardia.digital/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Option 2 — Local setup (npx cardia mcp)

If you'd rather run the MCP server on your machine (stdio), the CLI ships with it:

Install the CLI (or use npx directly)

$ npm install -g cardia

Get your token

$ export CARDIA_API_TOKEN=<your-token>

Add it to Claude Code in one line

$ claude mcp add cardia -- npx cardia mcp

For other clients, add this to the config and restart

claude_desktop_config.json

{
  "mcpServers": {
    "cardia": {
      "command": "npx",
      "args": ["cardia", "mcp"],
      "env": {
        "CARDIA_API_URL": "https://cardia-api.emipanelli.com",
        "CARDIA_API_TOKEN": "<your-token>"
      }
    }
  }
}

Compatible clients

Claude DesktopClaude CodeCursorChatGPTOpenClaw / Hermes

The 12 tools it exposes

The agent works with a scoped tool set. The authorizer validates every purchase against the real merchant and amount — not what the model claims.

list_cards

create_card

check_balance

set_limit

freeze_card

unfreeze_card

grant_permission

list_permissions

authorize_payment

get_transactions

create_purchase_card

reveal_card

Coming soon

OAuth: on the way

The hosted MCP already exists and authenticates with your token (Authorization: Bearer). Next up is OAuth: connect your account in one click, no token copying.

https://cardia.digital/api/mcp

CLI→API→Docs (ES)→

Ready to give your agent a card?

Join the waitlist and try the authorizer live in the demo.

Join →Try the demo