Install the Conto MCP server

The same @conto_finance/mcp-server package works in both Claude Desktop and Claude Code.

Already ran npx @conto_finance/create-conto-agent? Then npx conto mcp starts the MCP server with the SDK key and base URL from your generated config. No manual environment setup needed. The tabs below are for wiring the server into Claude Desktop or Claude Code directly.

Prerequisites

Claude Desktop or Claude Code installed
A Conto agent SDK key. Format conto_agent_.... See the Quickstart to generate one.

The MCP server always uses CONTO_API_KEY=conto_agent_.... Do not use an organization API key (conto_...) or CONTO_ORG_API_KEY here. If your backend also provisions agents or repairs ownership, do that separately with an organization API key and ContoAdmin.

Claude Code (CLI)
Claude Desktop (macOS)
Claude Desktop (Windows)

Add Conto as an MCP server in one command:

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

Environment flags must come before the --. Everything after -- is the command Claude Code runs for the server, so flags placed there would be passed to npx instead.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_KEY`	none	Yes. Agent SDK key, format `conto_agent_...`.
`CONTO_BASE_URL`	`https://conto.finance`	No. Override for local dev (e.g. `http://localhost:3006`).

Next steps

MCP tool reference

Full tool list, parameters, and responses

MCP overview

What MCP is and why Conto uses it

MCP Server Tools Reference

​Install the Conto MCP server

​Prerequisites

​Verify

​Manage the server

​Verify

​Verify

​Configuration reference

​Next steps

MCP tool reference

MCP overview

Install the Conto MCP server

Prerequisites

Verify

Manage the server

Verify

Verify

Configuration reference

Next steps