Skip to main content

QuantDataForge MCP servers — StrategyCreator + Open Cockpit, run locally via uvx with one API token.

Project description

qdf-mcp

Two MCP servers that let a QuantDataForge subscriber drive the platform from their own Claude Code / Claude Desktop:

  • qdf-mcp-strategyStrategyCreator: author trading strategies in Python, backtest them against QDF's 5-year 1-minute futures history (ES, NQ), and read the metrics + equity curve back — all in your Claude session.
  • qdf-mcp-cockpitOpen Cockpit: a live, read-only window into the open — which levels are armed, how each is defended tick-by-tick, plus market-state, options and catalyst reads.

Both are thin HTTPS clients. All the heavy lifting (data, backtest engine, sandbox) runs on the QDF server. Each server scopes everything to your personal API token.

Setup

1. Install uv (one time)

uvx runs the servers in an isolated environment and pulls all dependencies automatically — you do not need to install any Python packages by hand.

  • Windows: powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • macOS / Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

(Or pip install uv if you already have Python.)

2. Get your token

On the website, open Strategy Lab → API Tokens, click Generate, and copy the qdf_sk_… token (shown once). The same token works for both servers.

3. Add the servers to your Claude config

Paste this into your MCP client config — Claude Desktop's claude_desktop_config.json, or a project .mcp.json for Claude Code — with your token in both places:

{
  "mcpServers": {
    "strategy-creator": {
      "command": "uvx",
      "args": ["--from", "qdf-mcp", "qdf-mcp-strategy"],
      "env": {
        "QDF_API_TOKEN": "qdf_sk_…your token…",
        "QDF_API_URL": "https://quantdataforge.com"
      }
    },
    "qdf-cockpit": {
      "command": "uvx",
      "args": ["--from", "qdf-mcp", "qdf-mcp-cockpit"],
      "env": {
        "QDF_API_BASE": "https://quantdataforge.com",
        "COCKPIT_READ_TOKEN": "qdf_sk_…your token…"
      }
    }
  }
}

Don't need both? Keep just the block you want — they're independent and the same token authorizes either.

4. Restart your client and ask Claude

  • "Scaffold a breakout strategy and backtest it on ES 1m."
  • "Watch the cockpit and tell me when a level breaks."

The cockpit's live tools only return data during the watch window (~08:00–10:30 ET) with the feed up; outside that they report the feed is offline rather than erroring.

Requirements

Python ≥ 3.10 (uv manages this for you). The only dependencies are mcp and httpx, installed automatically by uvx.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qdf_mcp-0.2.0.tar.gz (13.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qdf_mcp-0.2.0-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

File details

Details for the file qdf_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: qdf_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 13.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.5

File hashes

Hashes for qdf_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 67ccd53fb00e771f7878aeb404f473d374a6d3d594d53a44d63ac33a65fc1fb1
MD5 4e81ddca5eee9ad4117a92b6d7415e9c
BLAKE2b-256 a456fe17be8c1fdf9a7aa1850a33713cf694915b8fbd3399bc49078f619332cd

See more details on using hashes here.

File details

Details for the file qdf_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: qdf_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 15.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.5

File hashes

Hashes for qdf_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 145222ad7456e6a3e62634534ec1b8918d720f05d49c62b038ee43d5dacb8b14
MD5 d05453d748fd32802885b3dda9fb1b2e
BLAKE2b-256 c4770e91921261e4ee66910ef38d6225ec4735219e3a805148baae0200aa4cf4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page