MCP server

The API is also available as an MCP server. MCP (Model Context Protocol) is a standard way for AI agents such as Claude or Cursor to use outside tools. With this server, an agent can manage your copy trading for you. It can list your accounts and copiers, set up a copier, add followers with their rules, pause and resume copying, and read what was copied.

https://mcp.algotradertools.com/mcp

It uses an API key, like the rest of the API. Each tool matches one API endpoint and follows the same rules as that endpoint, including its scopes, rate limits and errors.

Create a key for the agent

Create a separate key for each agent under API keys in the app, so you can revoke it on its own. Give it only the scopes the agent needs. The agent sees only the tools that its key's scopes allow.

Add it to your client

Claude Code

claude mcp add --transport http algotradertools https://mcp.algotradertools.com/mcp \
  --header "X-API-Key: $ATT_API_KEY"

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "algotradertools": {
      "url": "https://mcp.algotradertools.com/mcp",
      "headers": { "X-API-Key": "att_…" }
    }
  }
}

VS Code (.vscode/mcp.json, asks for the key once)

{
  "inputs": [
    { "type": "promptString", "id": "att-key", "description": "Algo Trader Tools API key", "password": true }
  ],
  "servers": {
    "algotradertools": {
      "type": "http",
      "url": "https://mcp.algotradertools.com/mcp",
      "headers": { "X-API-Key": "${input:att-key}" }
    }
  }
}

Claude Desktop and other clients that can only start local servers can reach it through mcp-remote (needs Node.js):

{
  "mcpServers": {
    "algotradertools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.algotradertools.com/mcp", "--header", "X-API-Key:${ATT_API_KEY}"],
      "env": { "ATT_API_KEY": "att_…" }
    }
  }
}

Wherever a client lets you set headers, Authorization: Bearer att_… works too.

Tools

A tool takes the same inputs as its endpoint: the path and query parameters and the request body, all at the same level. For example, update_follower takes copier_id, follower_id and the rules to change. The API reference describes each one in full.

There is no tool for connecting or reconnecting an account. Both need the broker password, and a password typed into a chat ends up in the AI provider's logs. Connect accounts in the app or through the API.

Errors

A failed tool call returns an error result with the API's problem details. The agent can read code, detail and the invalid fields in errors, and try again. A tool call outside the key's scopes fails with insufficient_scope.

Limits

Each key can send 120 messages a minute to the MCP server. A tool call also counts once toward the key's API limit of 120 requests a minute, the same as the matching request on the REST API. See Limits.

Request IDs

A tool call uses the request ID of the MCP message that carried it. So the X-Request-Id header of the response and the request_id in a tool's error are the same.