conto-mcp-server

MCP (Model Context Protocol) server for Conto — AI agent wallet management and payment authorization.

Gives Claude, Claude Code, and other MCP-compatible agents the ability to manage wallets, make payments, track transactions, and query analytics through Conto.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "conto": {
      "command": "npx",
      "args": ["conto-mcp-server"],
      "env": {
        "CONTO_API_KEY": "conto_agent_xxx...",
        "CONTO_BASE_URL": "https://www.conto.finance"
      }
    }
  }
}

Claude Code

claude mcp add conto -- npx conto-mcp-server \
  --env CONTO_API_KEY=conto_agent_xxx... \
  --env CONTO_BASE_URL=https://www.conto.finance

Getting an API Key

1. Sign in to Conto
2. Go to Agents and create or select an agent
3. Generate an API key from the agent's detail page
4. Use the key as CONTO_API_KEY

Available Tools

Payments

| Tool | Description | |------|-------------| | pay | Request and execute a payment in one step | | request_payment | Request payment authorization (check policies first) | | execute_payment | Execute a previously approved payment | | check_payment_status | Check status of a payment request |

Wallets & Limits

| Tool | Description | |------|-------------| | get_wallets | List all wallets linked to this agent | | get_spending_limits | Get current spending limits and remaining balances |

Transactions

| Tool | Description | |------|-------------| | list_transactions | List transactions with optional filters | | get_transaction | Get details of a specific transaction | | retry_transaction | Retry a failed transaction |

Agent-to-Agent (A2A)

| Tool | Description | |------|-------------| | a2a_send_request | Send a payment request to another agent | | a2a_list_requests | List incoming/outgoing A2A requests | | a2a_respond | Approve or reject an A2A request | | a2a_execute | Execute an approved A2A payment | | a2a_resolve_address | Check if an address belongs to a Conto agent |

Trust & Intelligence

| Tool | Description | |------|-------------| | check_address_trust | Get trust score and risk info for a wallet address | | list_counterparties | List known counterparties with trust levels | | get_counterparty | Get counterparty details and transaction history |

Monitoring

| Tool | Description | |------|-------------| | list_alerts | List active alerts and notifications | | respond_to_alert | Acknowledge or resolve an alert | | get_approval_requests | List pending approval requests |

Analytics & Info

| Tool | Description | |------|-------------| | get_analytics | Get spending analytics and trends | | get_policies | List spending policies assigned to this agent | | get_agent_info | Get information about this agent |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CONTO_API_KEY | Yes | — | Agent API key from Conto dashboard | | CONTO_BASE_URL | No | https://www.conto.finance | Conto API base URL |

Example Usage

Once configured, Claude can make payments naturally:

User: Pay $50 to OpenAI for API credits

Claude: I'll check the spending limits first, then send the payment... Payment of $50 USDC sent successfully. Transaction: 0xabc...

User: Show me this week's spending

Claude: Let me pull your analytics... You've spent $340 across 12 transactions this week, mostly on API providers.

License

MIT