Documentation Index
Fetch the complete documentation index at: https://conto.finance/docs/llms.txt
Use this file to discover all available pages before exploring further.
What is MCP?
MCP (Model Context Protocol) is an open protocol that allows AI agents to connect to external tools and data sources. Conto’s MCP server gives Claude and other MCP-compatible agents the ability to manage wallets, make payments, track transactions, and query analytics, with custody-aware policy controls across managed and external-wallet flows.Package
Install from npm:Quick Start
See Install MCP server for setup instructions covering Claude Desktop (macOS, Windows) and Claude Code (CLI).Getting an Agent SDK Key
- Sign in to Conto
- Go to Agents and create or select an agent
- Generate an SDK key from the agent’s detail page
- Use the
conto_agent_...key asCONTO_API_KEY
MCP uses an agent SDK key, not an organization API key. If your backend also provisions agents or
repairs ownership, use a separate
CONTO_ORG_API_KEY for that work.How It Works
- User requests an action — A user asks Claude to make a payment, check balances, or perform another financial operation in natural language.
- Policy evaluation — Claude calls Conto MCP tools. The server evaluates the request against your organization’s spending policies (limits, time windows, counterparty rules, etc.).
- Execution — If approved, the action is executed onchain and Claude reports the result with transaction details.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
CONTO_API_KEY | Yes | — | Agent SDK key from Conto dashboard |
CONTO_BASE_URL | No | https://conto.finance | Conto API base URL |
Available Tools
The MCP server exposes tools for payments, wallets, limits, budgets, trust checks, alerts, analytics, and setup reads. See the full tools reference for details.| Category | Tools | Description |
|---|---|---|
| Payments | 6 | Request, execute, and monitor payments |
| Wallets and limits | 3 | Query balances and spending limits |
| Budget requests | 2 | Request and check temporary budget increases |
| Transactions | 3 | List, fetch, retry transactions |
| x402 protocol | 4 | Pre-authorize and track x402 API micropayments |
| MPP protocol | 4 | Pre-authorize and track MPP payments |
| Card payments | 2 | Approve and confirm card transactions |
| Agent-to-agent | 6 | Send and manage inter-agent payments |
| Trust and counterparties | 4 | Trust scores and counterparty management |
| Alerts and approvals | 4 | Manage alerts and pending approval requests |
| Policies | 3 | Read and request policy exceptions |
| Agent info | 2 | Get agent profile and full data snapshot |
| Setup, audit, rate limits | 3 | Bootstrap config, audit log, rate-limit status |
| Analytics | 1 | Spending analytics |