MCP Server

Copy for Cursor / Claude

# AgentPay MCP Server Setup (for AI assistants)
#
# RECOMMENDED — Remote (no install needed):
#   claude mcp add --transport http agentpay https://api.agentpay.la/mcp \
#     --header "Authorization:Bearer agentpay_sk_live_..."
#
# OR Local: npx agentpay-mcp-server
# Setup:   npx agentpay-mcp-server --setup  (interactive signup)
#
# Tools: create_card, get_card_details, close_card, check_balance,
#         list_transactions, list_cards, check_account, agentpay_signup,
#         pay_checkout, fill_card, detect_checkout,
#         create_api_key, list_api_keys, revoke_api_key
#
# Key flow: create_card(amount, currency) -> get_card_details(card_id) -> close_card(card_id)
# Guard mode: create_card(amount, currency, guard=true) -> 15-min auto-expiry
# Chrome extension: pay_checkout auto-fills checkout forms (card never shown to LLM)
# Discovery: https://api.agentpay.la/.well-known/mcp.json
# MCP endpoint: https://api.agentpay.la/mcp

Remote MCP (recommended)

One command — no install needed:

claude mcp add --transport http agentpay https://api.agentpay.la/mcp \
  --header "Authorization:Bearer agentpay_sk_live_..."

This connects to the hosted MCP server at api.agentpay.la/mcp. No npm package, no local process. Works with Claude Code, Cursor, Windsurf, and any MCP client that supports HTTP transport.

Local MCP

Run the MCP server locally for full functionality including Chrome extension bridge:

npx agentpay-mcp-server

Or add to your MCP config:

{
  "agentpay": {
    "command": "npx",
    "args": ["agentpay-mcp-server"],
    "env": {
      "AGENTPAY_API_KEY": "agentpay_sk_live_..."
    }
  }
}

The local server includes 14 tools (vs 7 on remote) — adds Chrome extension bridge tools (pay_checkout, fill_card, detect_checkout), recipients, and Fintoc payments.

Available tools

Remote MCP (api.agentpay.la/mcp)

Tool	Description
`create_card`	Create a virtual card with amount and currency
`get_card_details`	Get PAN, CVV, expiry for a card (audit-logged)
`check_account`	Check if account is ready to create cards
`check_balance`	Check remaining balance on a card
`close_card`	Close a card and release unused funds
`list_transactions`	View transaction history
`list_cards`	List all cards (active, used, closed)

Local MCP (all of the above, plus)

Tool	Description
`agentpay_signup`	Create account for user (works without API key)
`pay_checkout`	Create card + fill checkout form in one call
`detect_checkout`	Scan browser tab for payment forms
`fill_card`	Fill existing card into checkout form
`create_api_key`	Create a new personal API key
`list_api_keys`	List active API keys
`revoke_api_key`	Revoke an API key

All tools have safety annotations (readOnlyHint, destructiveHint) so agents understand which actions are read-only vs destructive.

Compatible agents

Claude Code, Cursor, Windsurf, Cline, Goose, Codex, GitHub Copilot, AMP, OpenClaw, and any agent that supports MCP.

Discovery

MCP endpoint: https://api.agentpay.la/mcp
MCP discovery: https://api.agentpay.la/.well-known/mcp.json
Agent instructions: https://api.agentpay.la/.well-known/agent-instructions.md
OpenAPI: https://api.agentpay.la/openapi.json

Get Started

Concepts

Integrations

API Reference

Cards

Transactions

Organizations

Budgets & Agents