Skip to main content
COT-Reports
COT-Reports.com
COT-Reports
MCP server · AI assistants

COT data in ChatGPT, Claude, Gemini and Cursor

Free to start · All +380 markets · 9 tools · Reviewed October 2026

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.

https://mcp.cot-reports.com
Set up in a minuteHow to connectFree and PremiumWhat each plan includes
COT-Reportsworks with
COT-Reportsvia MCP

What are large speculators doing in gold this week?

callsget_latest_positions

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, Gemini, 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 Legacy reports for the last 26 weekly reports and the COT index over 26 or 52 weeks.
  • A free account adds 10 years of history and every COT index window.
  • COT Premium adds the full history, every report family, positioning extremes and close prices.
Connect

Add COT-Reports to your AI app

One address works everywhere. You can start without an account; when you want more, the app asks you to sign in to COT-Reports — a free account is enough for 10 years of history.

Claude — claude.ai, Claude Desktop and the mobile app

Step by step, as Claude shows it in October 2026 — app menus get renamed from time to time; the server address stays the same.

2 settings to get right: steps 3 and 4
https://mcp.cot-reports.com

  1. In Claude, open Customize → Connectors, click + Add, then Add custom connector.

  2. Name: COT-Reports. Server URL: https://mcp.cot-reports.com. Then Continue.

  3. Important

    Authentication: to use your COT-Reports account — a free account or COT Premium — choose Sign in now. Choose No sign in only to try the level without an account.

  4. Important

    OAuth client: choose Register automatically. Claude recommends Use Claude's published identity, but COT-Reports does not support that option yet — it fails.

  5. Click Add, then Connect. The COT-Reports page opens: sign in (or create a free account) and click Allow.

  6. The connector lists 9 tools. Claude asks before a tool runs; they only read COT data, so Allow always is safe.

  7. In a chat, open + → Connectors and switch COT-Reports on. Claude Desktop and the mobile app use the same connector — it belongs to your Claude account. The free Claude plan allows one custom connector.

Picked No sign in or the published identity by mistake? Sign-in settings cannot be changed afterwards: remove the connector and add it again.

Check that it works

In a new chat with COT-Reports switched on, ask:

When was the latest COT report published?

It works if the answer:

  • shows the tool get_release_schedule was called
  • names the CFTC report date and the next release
  • links to a COT-Reports page
Example answer

The latest CFTC report has positions as of Tuesday, 29 September 2026, released Friday, 2 October 2026. The next release is Friday, 9 October 2026 at 3:30 PM ET. cot-reports.com/cftc-release-schedule

Not working?

What you see, and what fixes it.

Claude

Claude never asks me to sign in, and I only get 6 months

You kept No sign in at step 3. Sign-in settings cannot be changed afterwards: remove the connector, add it again and choose Sign in now.

Claude

Connecting fails right after I click Connect

You chose Use Claude's published identity at step 4 — COT-Reports does not support it yet. Remove the connector, add it again and choose Register automatically.

Any app

The connector shows 0 tools

The sign-in did not finish. Disconnect and connect again, then click Allow on the COT-Reports page. Check that the address is exactly https://mcp.cot-reports.com, with nothing after it.

ChatGPT

I can't find where to add a custom MCP server

Custom MCP servers need a paid ChatGPT plan (OpenAI's help page lists which ones). The option is under Plugins → +; on older accounts, under Settings → Apps → Developer mode.

Gemini

Gemini shows no “Custom apps” section

Custom apps need a personal Google Account in the US, in English, age 18+, with Keep Activity on.

Disconnect an app

In your COT-Reports account, open Connected AI apps and click Disconnect — the app stops at its very next request. You can also remove the connector in the app itself.

Already have a COT Data API key?

Apps that accept a header can use your Data API key instead of signing in: every market and report family in raw form, counted together with your REST API calls (one key, one plan: the same limits on the REST API and the MCP server). All the keys of one account share these limits, on the REST API and the MCP server together.

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

What you can ask

All 9 tools
COT-Reportsvia MCP

What are large speculators doing in gold this week?

callsget_latest_positions
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.
Gold · LegacyLatest report · 29 Sep 2026
GroupLongShortNetΔ week
Large speculators249,73631,104+218,632−7,221
Commercials58,831309,798−250,967+11,936
Small traders48,78416,449+32,335−4,715
Gold on COT-Reports →

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

callsget_latest_snapshot
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?

callsscan_extremes
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 it stays locked, as on the website.

This is exactly what I needed — how do I connect it?

Tools

What the server can do

What each plan unlocks
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, by category — the full list comes page by page.
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. Without an account: 26 or 52 weeks.
scan_extremes
Markets where speculators are crowded long or short — COT Premium, as on the website.
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.

Without an account

Markets
All markets
History
The last 26 reports
Report families
Legacy
CFTC variants
Each report's default
Snapshot, weekly summary, release schedule
Included
COT index
26 or 52 weeks
Positioning extremes
Not included
Close prices
Not included
How to connect
Add the address — nothing else

Free account

Markets
All markets
History
10 years (520 reports)
Report families
Legacy
CFTC variants
Each report's default
Snapshot, weekly summary, release schedule
Included
COT index
Included
Positioning extremes
Not included
Close prices
Not included
How to connect
Sign in to COT-Reports when your app asks

COT Premium

Markets
All markets
History
Full history
Report families
Legacy, Disaggregated, TFF, Supplemental
CFTC variants
Futures Only + Futures & Options Combined
Snapshot, weekly summary, release schedule
Included
COT index
Included
Positioning extremes
Included
Close prices
Included
How to connect
Sign in with your Premium account

Data API key

Markets
All markets
History
Full history
Report families
Legacy, Disaggregated, TFF, Supplemental
CFTC variants
Futures Only + Futures & Options Combined
Snapshot, weekly summary, release schedule
Included
COT index
Included
Positioning extremes
With COT Premium on the account
Close prices
With COT Premium on the account
How to connect
Your key in the Authorization header

Every answer with COT data carries the CFTC report date and a link to the matching COT-Reports page. Fair use: a free account up to 30 questions a minute and 400 a day; COT Premium up to 60 a minute and 500 a day (personal use); a Data API key, the limits of its plan.

FAQ

Questions about the MCP server

Can’t find your answer? Write to contact@cot-reports.com and tell us which AI app you are connecting.

Helpful links
Plans and pricesWhat each plan unlocks in your AI appCOT Data APIThe same data for your own codeCOT data in your AI assistantThe blog guide: apps, levels, toolsData sourcesWhere the COT data comes from

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, to start: without an account the assistant reads every market for the last 26 weekly reports, with the COT index over 26 or 52 weeks; a free account adds 10 years of history and every COT index window. The full history, every report family, positioning extremes and close prices come with COT Premium.

Which AI apps work with it?

Any app that supports remote MCP servers over HTTP: Claude (web, desktop and mobile), ChatGPT (custom MCP servers), Claude Code, Cursor, VS Code with GitHub Copilot, Windsurf, Gemini CLI and others. Signing in (for more history) works in Claude, ChatGPT, Claude Code, Cursor, VS Code, and Gemini CLI (VS Code: the desktop app); on a remote extension host, use a COT Data API key instead. Editors that run inside a web browser (VS Code for the Web, github.dev) are not supported — use the desktop app.

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 with COT data names the report date.

What does my AI app see when I sign in?

Only that you are signed in and which plan you have, so the server knows how much history to return. The app cannot read or change your account, your saved markets or your payments, and you can disconnect it at any time from the app.

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, counted together with your REST API calls (one key, one plan: the same limits on the REST API and the MCP server). Positioning extremes and close prices are part of COT Premium; the COT index is included at every window. All the keys of one account share these limits, on the REST API and the MCP server together.