QuantGPT MCP

The data and trading platform for AI: decades of US market data, backtests in seconds.

QuantGPT is the data and trading platform for AI. Claude and ChatGPT connect over MCP to decades of US market data, and backtests run in seconds on QuantGPT Cloud. On QuantGPT Pro, your own strategy runs there too and trades in your own brokerage account. Start on the free plan, or try QuantGPT or QuantGPT Pro free for 3 days.

Updated October 2026. This repository holds no server code. It is the public listing for the hosted server: how to connect each client, what every tool does, example prompts, plans and limits.

What your AI can do with it

• Backtest any idea in seconds. Describe a strategy in plain words; your AI turns it into criteria (up to 8 filters, a rank, a holding count) and runs it walk-forward against a benchmark on decades of US market data, with a cost model and a decade-by-decade table. Up to 100 variants run in one call.
• Grade any US stock. A+ to F on six dimensions against the whole market, point in time, with the drivers, the peers and a chart pack. Up to 25 tickers in one call, or the leaderboard for a sector.
• Query the data itself. Prices, total returns, fundamentals joined by filing date, 55+ factors, FRED macro, insider filings and short interest, through ready-made calls or read-only SQL over the whole warehouse.
• Start from the literature. 175 documented strategies from papers, books and practitioners, 63 of them runnable in one call.
• Work on a portfolio. A frontier over your tickers, a review of your holdings, the trade list from your criteria to the book they imply today, paper books marked nightly, and alerts when a name enters or leaves a screen.
• Go past US stocks. Commodity futures, macro regimes, weather studies, crypto with funding rates, prediction markets and memecoins.
• Chart and cite. Branded charts with the numbers that drew them, and search and fetch so ChatGPT deep research can cite the library, the studies and the forum.
• Run your own strategy on QuantGPT Pro. QuantGPT Cloud hosts your strategy as your own code, on your schedule, and it trades in your own brokerage account under your keys. You set it up in the terminal; no MCP tool places an order.

Contents

1. Connect your AI
2. What your AI can call
3. Strategies you can ask about
4. Plans and limits
5. What the data is, and is not
6. Disclaimer

Connect your AI

Claude, ChatGPT and the Gemini app sign in to QuantGPT through OAuth: no key to paste. The connection lands on your account page as a key labelled with the client's name, and you can revoke it there. Claude Code, Gemini CLI, Cursor and any other client below use a key.

Get a key

1. Sign in at https://terminal.quantgpt.co (new here? start free: no card).
2. Open your account page. Under Keys for your AI, type a label and press Issue key.
3. Copy the qg_sk_... value now. Only its hash is stored, so it is shown once.

Claude (claude.ai and Claude Desktop)

1. Customize > Connectors, then + > Add custom connector (on Team or Enterprise an Owner may need to add it first).
2. Name it QuantGPT, paste https://terminal.quantgpt.co/mcp, leave the OAuth client fields empty, and click Add.
3. Press Connect. Claude opens QuantGPT's sign-in page: sign in and approve. The connection shows on your account page as connector: Claude.

Guide on quantgpt.co: https://quantgpt.co/learn/connect-claude.html

Claude Code

claude mcp add --transport http quantgpt https://terminal.quantgpt.co/mcp --header "Authorization: Bearer qg_sk_YOUR_KEY"

Add --scope user to have it in every project. Then ask Claude Code to call describe_capabilities.

ChatGPT

1. In ChatGPT, Settings > Security and login > turn on Developer mode. OpenAI offers it on Plus, Pro, Business, Enterprise and Education accounts, on the web.
2. Go to chatgpt.com/plugins and select the plus button. Name the app QuantGPT and, under Connection, enter https://terminal.quantgpt.co/mcp.
3. ChatGPT registers itself and sends you to QuantGPT's sign-in, now or on its first call. Sign in and press CONNECT; there is no key to paste. The connection shows on your account page as connector: plus the name ChatGPT registered. In a chat, choose Developer mode from the + menu and select QuantGPT.

On a Business, Enterprise or Education workspace, developer mode can depend on the workspace's policy, so an admin may have to allow it first. ChatGPT deep research works through a connector's search and fetch tools; QuantGPT ships both, so deep research can search the library, the studies and the forum and cite what it used.

Guide on quantgpt.co: https://quantgpt.co/learn/connect-chatgpt

Gemini

Gemini CLI, with a key:

gemini mcp add -s user --transport http --header "Authorization: Bearer qg_sk_YOUR_KEY" quantgpt https://terminal.quantgpt.co/mcp

-s user saves it in ~/.gemini/settings.json in your home folder. Without it, Gemini CLI saves to the current project's .gemini/settings.json, where a key can end up in a git repository.

Or add it to ~/.gemini/settings.json (every project) or .gemini/settings.json (one project):

{
  "mcpServers": {
    "quantgpt": {
      "httpUrl": "https://terminal.quantgpt.co/mcp",
      "headers": { "Authorization": "Bearer qg_sk_YOUR_KEY" }
    }
  }
}

Run /mcp inside Gemini CLI to see the server and its tools.

The Gemini app: at gemini.google.com open Settings > Connected Apps, and under Custom apps choose Add a custom app. Paste https://terminal.quantgpt.co/mcp, then sign in to QuantGPT. Google decides who can add custom apps (in September 2026: 18 or over, in the US, signed in with a personal Google Account, Keep Activity on, set up in the web app): https://support.google.com/gemini/answer/17209137

Guide on quantgpt.co: https://quantgpt.co/learn/connect-gemini

Cursor

In .cursor/mcp.json (one project) or ~/.cursor/mcp.json (every project):

{
  "mcpServers": {
    "quantgpt": {
      "url": "https://terminal.quantgpt.co/mcp",
      "headers": { "Authorization": "Bearer ${env:QUANTGPT_KEY}" }
    }
  }
}

Set QUANTGPT_KEY to your qg_sk_... key in the environment Cursor starts from, so the key never sits in the file.

Guide on quantgpt.co: https://quantgpt.co/learn/connect-cursor

Any other MCP client

URL:   https://terminal.quantgpt.co/mcp
Auth:  Authorization: Bearer qg_sk_YOUR_KEY   (X-API-Key: qg_sk_YOUR_KEY is also accepted)
Type:  Streamable HTTP, JSON-RPC 2.0, stateless

A request without a valid key gets 401 and a WWW-Authenticate header that points OAuth clients to https://terminal.quantgpt.co/.well-known/oauth-protected-resource.

No connector option on your plan? The setup prompt at https://terminal.quantgpt.co/pastepack.txt gives any chat AI the same context in one block you paste, without MCP. Signed-in members find the Claude and ChatGPT steps, this address and the prompt library at https://terminal.quantgpt.co/connect.

Your first call

Ask your AI to call describe_capabilities: it returns the whole map (every factor, operator, benchmark, library category and methodology rule). On connect the server lists 14 core tools and 5 discovery tools; the other 57 sit in seven categories. Your AI calls available_categories, then activate_category, to list a category for your key, or runs any tool by name through call_tool. With a key-based client you can add ?tools=all to the URL to list every tool at once.

What your AI can call

76 tools, 68 of them switched on today; the 8 marked (coming soon) answer with a coming-soon note until they open. None of them places, modifies or cancels an order at any broker. A few write to your own QuantGPT account: saved studies, paper books, sealed books, alerts, event rules and the panels on your terminal.

Listed on connect (14)

Discovery (5)

Equities: category equities (21)

Portfolio: category portfolio (8)

Macro: category macro (4)

Alternative markets: category alt_markets (13)

Events: category events (3)

Charts: category charts (3)

Your terminal: category desk (5)

Strategies you can ask about

A sample from the library of 175 documented strategies (63 of them runnable), drawn from papers, books and practitioners. They are listed so you can test them, not as promises. A library run is the closest the warehouse's factor vocabulary gets to the published rule, and every run says what it approximates. Run one and read its losing years before you trust it.

Ask: "Run the library strategy piotroski-2000, show me its losing years and its worst drawdown, and tell me what the run approximates from the paper." More prompts: examples/prompts.md and examples/first-session.md. Browse the whole library at https://quantgpt.co/library/.

Plans and limits

• QuantGPT and QuantGPT Pro start with 3 days free: card up front, cancel any time. The trial includes 5 backtests and 5 AI calls.
• An AI call is one tool call. Connecting, listing tools and pings do not count. The count is per account, across all of its keys.
• A per-minute limit per account also applies. Past it the server answers 429; try again a minute later.
• Some tools depend on the plan: portfolio_review opens on QuantGPT Pro, count_bets on QuantGPT and QuantGPT Pro, and strategy_alerts allows 3 alerts on QuantGPT and unlimited alerts on QuantGPT Pro.
• Teams: Business is custom (seats, limits built for your volume) and starts with a conversation at https://quantgpt.co/contact.

Plans: https://quantgpt.co/#plans. Start: https://terminal.quantgpt.co/join.

What the data is, and is not

• Companies that later delisted are priced from 1998 and are in the market-wide backtest universe from then on; earlier years hold survivors only. A backtest on a list of tickers you choose, and a rule on a single index, are not affected. The server tells your AI to say so whenever it reports a market-wide result.
• Fundamentals are joined by filing date. About 9% of rows still carry the quarter-end as the filing date, so those quarters are seen early; a fix is in progress.
• Factor data begins in 1990. Macro series are the latest vintage; revisions are not modelled.
• Results are gross by default. Every run_backtest result also carries turnover and net figures at 5, 10, 25 and 50 bps per side.
• Every run_backtest result returns its worst drawdown, a decade-by-decade table and the full return series, so the losing years are in the result; its chart pack draws them year by year.
• The same criteria return the same numbers, to the last digit.
• Futuretests replay the record of past episodes. They do not forecast.
• Public data checks, no account needed: https://terminal.quantgpt.co/verify

Disclaimer

QuantGPT is research and education software. Nothing it returns is investment advice or a recommendation to buy, sell or hold anything, and nothing is tailored to you. Every backtest, study, screen, futuretest and library entry is hypothetical and describes the past; past performance, real or simulated, does not indicate or guarantee future results.

No tool on this server places, modifies or cancels an order, and none connects to a broker. Where a tool produces a trade list or a signal, you or your own software act on it, at your own broker, under your own keys. On QuantGPT Pro, QuantGPT Cloud hosts your own strategy as your own code and sends the orders your code makes to your own brokerage account, under your keys; QuantGPT never decides, sizes or times a trade. That runs in the terminal, not through this server.

Full terms: https://quantgpt.co/terms. Risk and methodology disclosures: https://quantgpt.co/disclosures. Privacy: https://quantgpt.co/privacy. Security: https://quantgpt.co/security.

QuantGPT LLC. Questions: https://quantgpt.co/contact.