@conto_finance/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_finance/mcp-server"],
      "env": {
        "CONTO_API_KEY": "conto_agent_xxx...",
        "CONTO_BASE_URL": "https://conto.finance"
      }
    }
  }
}

Claude Code

claude mcp add conto -- npx @conto_finance/mcp-server \
  --env CONTO_API_KEY=conto_agent_xxx... \
  --env CONTO_BASE_URL=https://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 (45)

Payments (6)

| 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 | | approve_external_payment | Request approval for an external (agent-held) wallet | | confirm_external_payment | Confirm an externally-executed payment with tx hash |

Wallets & Limits (3)

| Tool | Description | | --------------------- | -------------------------------------------------- | | get_wallets | List all wallets linked to this agent | | get_wallet | Get details of a specific wallet | | get_spending_limits | Get current spending limits and remaining balances |

Transactions (3)

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

x402 Protocol (4)

| Tool | Description | | -------------------- | -------------------------------------------------- | | x402_get_budget | Check remaining x402 budget and burn rate | | x402_pre_authorize | Pre-authorize an x402 API payment against policies | | x402_record | Record a completed x402 payment (single or batch) | | x402_list_services | List x402 services with spend and pricing stats |

MPP Protocol (4)

| Tool | Description | | ------------------- | ------------------------------------------------ | | mpp_get_budget | Check remaining MPP budget and burn rate | | mpp_pre_authorize | Pre-authorize an MPP payment against policies | | mpp_record | Record a completed MPP payment (single or batch) | | mpp_list_services | List MPP services with spend and pricing stats |

Card Payments (2)

| Tool | Description | | -------------- | ---------------------------------------------------- | | card_approve | Request approval for a card payment against policies | | card_confirm | Confirm a card payment was completed |

Agent-to-Agent (A2A) (6)

| 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 | | a2a_get_stats | Get A2A payment statistics |

Trust & Intelligence (4)

| 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 | | create_counterparty | Create or update a counterparty |

Monitoring (4)

| Tool | Description | | ----------------------- | ------------------------------------ | | list_alerts | List active alerts and notifications | | get_alert | Get details of a specific alert | | respond_to_alert | Acknowledge or resolve an alert | | get_approval_requests | List pending approval requests |

Analytics & Info (7)

| Tool | Description | | -------------------------- | --------------------------------------------- | | get_analytics | Get spending analytics and trends | | get_policies | List spending policies assigned to this agent | | request_policy_exception | Request an exception to a spending policy | | list_policy_exceptions | List policy exception requests | | get_agent_info | Get information about this agent | | get_all | Get comprehensive agent data in one call | | get_setup | Get agent setup and configuration |

Audit & Rate Limits (2)

| Tool | Description | | ----------------- | ------------------------------------------- | | get_audit_logs | Get audit logs of agent actions | | get_rate_limits | Get current API rate limit status and usage |

Environment Variables

| Variable | Required | Default | Description | | ---------------- | -------- | ----------------------- | ---------------------------------- | | CONTO_API_KEY | Yes | — | Agent API key from Conto dashboard | | CONTO_BASE_URL | No | https://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