MCP Server

To connect Claude Code to the QC MCP Server, follow these steps:

1. Install and open Docker Desktop.
2. Install Claude Code.
3. In a terminal, pull the QC MCP Server from Docker Hub.

$ docker pull quantconnect/mcp-server

If you have an ARM chip, add the --platform linux/arm64 option.

4. Save the following configuration file on your computer:

   {
     "mcpServers": {
       "quantconnect": {
         "command": "docker",
         "args": [
           "run",
           "-i",
           "--rm",
           "-e", "QUANTCONNECT_USER_ID",
           "-e", "QUANTCONNECT_API_TOKEN",
           "-e", "AGENT_NAME",
           "--platform", "<your_platform>",
           "quantconnect/mcp-server"
         ],
         "env": {
           "QUANTCONNECT_USER_ID": "<your_user_id>",
           "QUANTCONNECT_API_TOKEN": "<your_api_token>",
           "AGENT_NAME": "MCP Server"
         }
       }
     }
   }

   To get your user Id and API token, see Request API Token.

   Our MCP server is multi-platform capable. The options are linux/amd64 for Intel/AMD chips and linux/arm64 for ARM chips (for example, Apple's M-series chips).

   If you simultaneously run multiple agents, set a unique value for the AGENT_NAME environment variable for each agent to keep record of the request source.

5. In a terminal, navigate to the directory you want Claude to operate in and then run claude --mcp-config <path_to_your_config_file>.

$ claude --mcp-config C:/Users/derek/quantconnect_mcp_config.json

You can even use the terminal in Visual Studio Code. To open it, click View > Terminal from the main menu.

To keep the Docker image up-to-date, in a terminal, pull the latest MCP server from Docker Hub.

$ docker pull quantconnect/mcp-server

If you have an ARM chip, add the --platform linux/arm64 option.

There are no quotas on the QuantConnect API, but the Claude has some. To view the quotas, see Does Claude have any message limits? on the Anthropic website.

The following sections explain some issues you may encounter and how to resolve them.

No Tools Available

When you open your MCP client, it can take up to 30 seconds for the MCP server to start up and for the client to connect to it. Before you start entering prompts, check Docker Desktop to ensure the container is running and run /mcp in Claude Code to ensure the QuantConnect tools are available.

If the client can’t discover the tools after 30 seconds, follow these steps:

1. In the terminal, press Ctrl+C twice to exit Claude Code.
2. If the server doesn’t automatically shut down in Docker Desktop, click the trash icon to shut it down.

3. Restart the Claude Code.

Connection Error Code -32000

The docker run ... command in the configuration file also accepts a --name option, which sets the name of the Docker container when the MCP Server starts running. If your computer tries to start up two MCP Server containers with the same name, this -32000 error occurs. To avoid the error, remove the --name option and its value from the configuration file. For an example of a working configuration file, see Getting Started.

Service Outages

The MCP server relies on the QuantConnect API and the client application. To check the status of the QuantConnect API, see our Status page. To check the status of Claude Code and Claude AI, see the Anthropic Status page.

The following examples demonstrate the MCP server with Claude Code.

Example 1: Hello World

To test the server and client are working and connected, enter the following prompt into Claude Code:

> Read my QuantConnect account.

Claude should call the read_account tool.

Example 2: LLM-Focused Workflow from Powershell

This example uses Claude Code in a terminal window to create a new project, edit files, run backtests, and interpret backtest results.

Example 3: Hybrid Workflow with Local Platform

This example uses Claude Code in Local Platform to edit the project files, deploy backtests, and deploy the algorithm to paper trading.