MCP server · AI assistants

COT data in ChatGPT, Claude and Cursor

Add one address to your AI assistant and ask about the Commitments of Traders in plain language. It reads the latest CFTC report for all +380 markets from COT-Reports and cites the report date and the page.

Server addresshttps://mcp.cot-reports.com

Set up in a minuteHow to connect Free and PremiumWhat each plan includes

What are large speculators doing in gold this week?

Your assistant calls COT-Reports, reads the latest CFTC report for gold — long, short and net position of every trader group, the weekly change — and answers with the report date and a link to the page.

In short

What is the COT-Reports MCP server?

The COT-Reports MCP server connects AI assistants such as ChatGPT, Claude, Cursor and VS Code to the weekly CFTC Commitments of Traders data through the Model Context Protocol (MCP). Add https://mcp.cot-reports.com as a connector and ask in plain language: the positions of speculators and hedgers, weekly changes and open interest for all +380 markets. Without an account the assistant reads the latest report of every market; a COT Data API key adds the full history and every report family. Connecting a free account (the last 4 reports) or COT Premium (everything) from your AI app is coming soon.

Connect

Add COT-Reports to your AI app

One address works everywhere, with no account: the latest report of every market. Connecting your COT-Reports account from your AI app — a free account for the last 4 reports, COT Premium for everything — is coming soon; a COT Data API key already works in apps that accept a header.

Claude (web, desktop, mobile)

Settings → Connectors → Add custom connector. Name it COT-Reports and paste https://mcp.cot-reports.com. Available on every Claude plan (the Free plan allows one custom connector).

ChatGPT

Settings → Apps → Advanced settings → turn on Developer mode, then create an app with the address https://mcp.cot-reports.com. Available on ChatGPT Plus, Pro, Business, Enterprise and Edu.

Claude Code

Run this in your terminal — that is all: the latest report of every market, no account needed.

claude mcp add --transport http cot-reports https://mcp.cot-reports.com

Cursor

Add this to ~/.cursor/mcp.json (or to your project's .cursor/mcp.json).

{
  "mcpServers": {
    "cot-reports": {
      "url": "https://mcp.cot-reports.com"
    }
  }
}

VS Code (GitHub Copilot)

Add this to .vscode/mcp.json in your project, or run “MCP: Add Server” from the command palette.

{
  "servers": {
    "cot-reports": {
      "type": "http",
      "url": "https://mcp.cot-reports.com"
    }
  }
}

Gemini CLI

Add this to ~/.gemini/settings.json.

{
  "mcpServers": {
    "cot-reports": {
      "httpUrl": "https://mcp.cot-reports.com"
    }
  }
}

Already have a COT Data API key?

Apps that accept a header can use your Data API key today: every market and report family in raw form, counted on the same quota as the REST API.

claude mcp add --transport http cot-reports https://mcp.cot-reports.com \
  --header "Authorization: Bearer cot_live_…"

Example

What you can ask

What are large speculators doing in gold this week?

The assistant calls get_latest_positions for gold and answers with the long, short and net position of every trader group in the latest CFTC report, the change since last week and the share of open interest — with the report date and a link to the gold page on COT-Reports.

Give me this week's COT overview of the currency futures.

It calls get_latest_snapshot for the currencies category: the net position of speculators and commercials in every currency future, their weekly change and the open interest, in one answer.

Which markets have the most crowded speculator positioning right now?

It calls scan_extremes. With COT Premium you get the list — each market with its 26-, 52- and 156-week percentiles; on the other plans the assistant tells you how many markets are crowded long and short.

Tools

What the server can do

list_markets: Finds markets by name, ticker, category or report family, with their CFTC codes.
get_latest_snapshot: The latest Legacy report of every market in one answer, by category.
get_latest_positions: One market's latest report: long, short and net per trader group, weekly change, % of open interest.
get_history: Weekly history for one market — the depth depends on the plan.
get_cot_index: The COT index (0–100) of speculators and commercials over 26 to 260 weeks. COT Premium.
scan_extremes: Markets where speculators are crowded long or short. The list is COT Premium; the counts are open to everyone.
get_weekly_summary: The weekly summary of the 35 main markets.
get_release_schedule: The latest report date and the next CFTC release, holidays included.
explain_cot: Short explanations of COT concepts, with links to the guides.

Plans

What each plan includes

Every market is open at every level. The levels differ by history depth, report families and the analysis tools.

Feature	Without an account	Free account	COT Premium	Data API key
Markets	All +380	All +380	All +380	All +380
History	Latest report	Last 4 reports	Full history	Full history
Report families	Legacy	Legacy	Legacy, Disaggregated, TFF, Supplemental	Legacy, Disaggregated, TFF, Supplemental
Snapshot, weekly summary, release schedule
COT index
Positioning extremes	Counts only	Counts only		Counts only
Close prices
How to connect	Add the address — nothing else	Coming soon	Coming soon (a Data API key works today)	Your key in the Authorization header

Every answer carries the CFTC report date and a link to the matching COT-Reports page. Fair-use limits apply per account and per key.

FAQ

Questions about the MCP server

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants use outside services. With the COT-Reports MCP server, your assistant reads the CFTC Commitments of Traders data from COT-Reports instead of guessing from the web.

Is it free?

Yes: without an account the assistant reads the latest report of all +380 markets. Free accounts (the last 4 reports) and COT Premium (the full history, every report family, the COT index, positioning extremes and close prices) are coming soon to the MCP server; a COT Data API key already adds the full history and every report family.

Which AI apps work with it?

Any app that supports remote MCP servers over HTTP: Claude (web, desktop and mobile), ChatGPT with Developer mode, Claude Code, Cursor, VS Code with GitHub Copilot, Windsurf, Gemini CLI and others.

How fresh is the data?

The same data as the website: the CFTC publishes the report every Friday at 3:30 pm US Eastern, and COT-Reports updates within minutes. Every answer names the report date.

When can I use my COT-Reports account in my AI app?

Soon. For now the server answers without an account. When accounts arrive, your AI app will ask you once to connect your COT-Reports account; the app will only read COT data at your plan's level, and you will be able to disconnect it at any time.

I have a COT Data API key — can I use it?

Yes. Apps that accept a header (Claude Code, Cursor, VS Code…) can send your key as a Bearer token: every market and report family in raw form, on the same quota as the REST API. The COT index, positioning extremes and close prices are part of COT Premium.