Machine View

Install MCP Server

Source: https://conto.finance/docs/mcp/install

# Install MCP Server

> Add the Conto MCP server to Claude Desktop or Claude Code so the agent can use natural language for wallet and payment operations

- Human URL: https://conto.finance/docs/mcp/install
- Raw Markdown: https://conto.finance/docs/mcp/install.md
- Terminal view: https://conto.finance/ai/docs/mcp/install

Documentation group: Build

# 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](https://claude.ai/download) or [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
- A Conto agent SDK key. Format `conto_agent_...`. See the [Quickstart](https://conto.finance/quickstart/setup) 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`.

    Add Conto as an MCP server in one command:

    ```bash
    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

    ```bash
    claude mcp list      # list configured MCP servers
    claude mcp remove conto
    ```

    Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:

    ```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

    1. Restart Claude Desktop.
    2. Look for the tools icon in the chat input. Conto's tools should appear in the list.
    3. Ask: "What are my wallet balances?"

    Edit `%APPDATA%\Claude\claude_desktop_config.json`:

    ```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

    1. Restart Claude Desktop.
    2. Look for the tools icon in the chat input.
    3. 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
Link: https://conto.finance/mcp/tools

    Full tool list, parameters, and responses

### MCP overview
Link: https://conto.finance/mcp/overview

    What MCP is and why Conto uses it