Tiny Agent Company Mcp

@agent-cards/mcp

Give your AI agent a debit card. AgentCard lets AI agents create and spend virtual debit cards — each with a fixed budget, real card credentials, and full MCP integration. Your agent can create a card, pay for things, check its balance, and auto-fill checkout forms — without ever needing your personal card.

Quick Setup

The fastest way to connect your agent is through the CLI:

npx agent-cards signup    # create an account (one-time)
npx agent-cards setup-mcp # auto-configures Claude Code

That's it. Restart Claude Code and the tools are ready to use.

Manual Setup

HTTP (recommended)

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "agent-cards": {
      "url": "https://mcp.agentcard.sh/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

Get your JWT with npx agent-cards login, then find it in ~/.agent-cards/config.json.

stdio (local)

{
  "mcpServers": {
    "agent-cards": {
      "command": "node",
      "args": ["/path/to/packages/mcp/dist/src/index.js"],
      "env": {
        "AGENT_CARDS_JWT": "",
        "AGENT_CARDS_API_URL": "https://your-backend.example.com"
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | list_cards | List all virtual cards with balances, expiry, and status | | create_card | Create a new virtual debit card with a fixed USD budget | | get_card_details | Get decrypted PAN, CVV, expiry (may require human approval) | | check_balance | Fast balance check without exposing credentials | | close_card | Permanently close a virtual card | | list_transactions | List transactions for a card with optional status filter | | approve_request | Approve or deny a pending human-in-the-loop request | | submit_user_info | Submit identity info for card issuance verification | | setup_payment_method | Set up a payment method for funding cards | | remove_payment_method | Remove a saved payment method | | pay_checkout | Auto-detect and pay a checkout page using an AgentCard | | detect_checkout | Detect checkout forms on the current browser tab | | fill_card | Fill card credentials into a payment form in the browser | | start_support_chat | Start a support conversation | | send_support_message | Send a message in a support thread | | read_support_chat | Read support conversation history |

Endpoints

| Method | Path | Description | |--------|------|-------------| | POST | /mcp | MCP Streamable HTTP transport | | GET | /health | Health check ({"ok":true}) | | GET | /.well-known/mcp/server-card.json | Auto-discovery metadata |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AGENT_CARDS_API_URL | yes | Backend API URL | | AGENT_CARDS_JWT | stdio only | User JWT (HTTP gets it from the Authorization header) | | PORT | no | HTTP server port (default: 3002) |

Development

pnpm dev       # stdio mode
pnpm dev:http  # HTTP mode
pnpm build     # compile TypeScript

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tiny-agent-company
• Source: tiny-agent-company/mcp
• License: MIT

Install and usage instructions live in the source repository linked above.