Install the Conto MCP server The same @conto_finance/mcp-server package works in both Claude Desktop and
Claude Code .
Prerequisites The MCP server always uses CONTO_API_KEY=conto_agent_.... Do not use an organization API key
(conto_...) or CONTO_ORG_API_KEY here.
Claude Code (CLI)
Claude Desktop (macOS)
Claude Desktop (Windows)
Add Conto as an MCP server in one command: claude mcp add conto -- npx @conto_finance/mcp-server \ --env CONTO_API_KEY=conto_agent_xxx... \ --env CONTO_BASE_URL=https://conto.finance
Replace conto_agent_xxx... with your actual SDK key. Verify Start a new Claude Code session: > What are my wallet balances?
Claude will invoke the get_wallets tool. Manage the server claude mcp list # list configured MCP servers claude mcp remove conto
Edit ~/Library/Application Support/Claude/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" } } } }
Replace conto_agent_xxx... with your actual SDK key. Verify
Restart Claude Desktop.
Look for the tools icon in the chat input. Conto’s tools should appear in the list.
Ask: “What are my wallet balances?”
Edit %APPDATA%\Claude\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" } } } }
Replace conto_agent_xxx... with your actual SDK key. Verify
Restart Claude Desktop.
Look for the tools icon in the chat input.
Ask: “What are my wallet balances?”
Configuration reference Env var Default Required CONTO_API_KEYnone Yes. Agent SDK key, format conto_agent_.... CONTO_BASE_URLhttps://conto.financeNo. Override for local dev (e.g. http://localhost:3006).
If your backend also provisions agents or repairs ownership, do that separately with an
organization API key and ContoAdmin. The MCP runtime itself should still receive an agent SDK
key.
Next steps
MCP tool reference Full tool list, parameters, and responses
MCP overview What MCP is and why Conto uses it