- Developers
- MCP server
TradeEasy MCP server
TradeEasy as native, read-only tools in Claude, ChatGPT, Cursor and any MCP client. Your assistant does the reasoning; TradeEasy supplies the data.
https://api.tradeeasyai.net/public/v1/mcpConnect your AI#
Pick where your assistant lives. Claude, ChatGPT and Claude Code sign in with OAuth; Cursor and custom clients use your key.
OAuth · no key needed
- Open Settings → Connectors in Claude, then click Add custom connector.
- Name it TradeEasy and paste the server URL:
- Click Add and approve in the browser tab that opens — log in to TradeEasy and hit Approve. No key to paste.
- In a chat, open the tools menu (sliders icon) and make sure the TradeEasy connector is enabled.
Included in every plan, starting with Starter. Rate limits are per key; an OAuth connection counts as your account. Key-based clients use the key from your developer console.
https://api.tradeeasyai.net/public/v1/mcpTools#
24 tools, all read-only and idempotent. Each result carries served_at, data_as_of, attribution and the disclaimer.
| Tool | Kind | Returns | Arguments |
|---|---|---|---|
| get_economic_calendar | Context | Releases scheduled for the next 1–7 days plus the last 24 h of prints, with consensus, previous and actual. | days 1–7, country |
| get_breaking_news | Context | The last 24 h of events, or keyword search over up to 7 days. Optional symbol filter. | symbol, query, hours 1–168 |
| get_cot | Context | CFTC Legacy report nets for a futures-linked asset: speculators, commercials, small traders. | symbol (required) |
| get_earnings_calendar | Context | A stock’s next report date with consensus EPS and revenue and its last surprise, or the index heavyweights reporting in the next days. | symbol, days 1–14 |
| get_prediction_markets | Context | Polymarket implied odds for events tied to an asset. Third-party crowd odds. | symbol (required) |
| get_macro_surprises | Research | Realised releases with consensus, actual and the surprise. Defaults to the last 90 days. | start, end, country, event_contains, limit |
| list_series | Research | Every series available to get_series and get_panel, with unit, frequency, source and licence. | category, search |
| get_series | Research | One series over a date window as columns + data. Up to 2,000 rows a call. | series_id (required), symbol, start, end, limit |
| get_panel | Research | Several series across several symbols in one long-format table. | series_ids (required), symbols, start, end, limit |
| get_dataset_citation | Research | Version, licence terms and how to read served_at and data_as_of. | none |
| verify_accuracy_integrity | Research | Recomputes the prediction ledger hash chain and reports the first break, if any. | none |
13 tools return model scores, probabilities or levels · reference only
Listed with their arguments for reference. They are never used in examples here, and the docs show no sample values from them.
| Tool | Kind | Returns | Arguments |
|---|---|---|---|
| get_sentiment | Model output | The pipeline’s direction, confidence, reasoning and probabilities for one asset. | symbol (required) |
| get_market_regime | Model output | The US risk environment with score and confidence, plus intraday breadth. | none |
| get_morning_brief | Model output | The latest pre-market brief: regime, mood, key assets and setup guidance. | none |
| get_todays_drivers | Model output | An asset’s or the market’s day so far: recap, scheduled and news drivers, positioning and the volatility regime. | symbol |
| get_opportunity_scores | Model output | A 0–100 confluence ranking across assets. | limit 1–25 |
| get_trade_ideas | Model output | Active idea scenarios with reference, invalidation and objective levels. | symbol |
| get_sentiment_divergence | Model output | Where sentiment diverges from price or positioning. Experimental. | symbol, limit 1–20 |
| get_weekly_profile | Model output | This week’s Monday-reference bias and range for a symbol. | symbol (required) |
| get_doom_score | Model output | A 0–100 market-wide systemic-risk gauge and the indicators firing. | none |
| get_yield_curve | Model output | Treasury spreads, inversion status and a recession-risk level. | none |
| get_fundamental_strength | Model output | Ranked 0–100 macro strength per FX, index or commodity group. | group fx | index | commodity |
| get_accuracy_record | Model output | The scored prediction track record, one row per call, with the probability assigned before the outcome. | symbol, start, end, limit |
| get_volatility_index | Model output | TradeEasy’s 0–100 Volatility Index for one asset, Day and Swing, with its size word and drivers. | symbol (required), horizon both | day | swing |
Research series include headline tone: news_tone.class_net and news_tone.class_n, per UTC day and asset class, from the point-in-time hourly rollup. Counts and ratios only; headline tone, not a price direction.
tools/call · get_cot
{
"symbol": "XAUUSD",
"report_date": "2026-10-20",
"positioning": {
"net_speculator": 199865,
"net_commercial": -235582,
"net_retail": 35717,
"net_speculator_change_1w": -8014,
"flow_label": "New shorts",
"positioning_extreme": false
},
"data_as_of": "2026-10-20",
"served_at": "2026-10-24T11:29:35Z",
"attribution": "via TradeEasy — https://tradeeasyai.net"
}Try asking#
Each prompt uses a different tool. Answers say when the data is from.
What high-impact US releases are on the calendar in the next 48 hours?
get_economic_calendarWhere are large speculators positioned in gold futures, and what changed this week?
get_cotHow did US retail sales print versus consensus this month?
get_macro_surprisesAny breaking news on OPEC in the last three days?
get_breaking_newsHow should I cite TradeEasy data in a research note?
get_dataset_citation
Troubleshooting#
The connector will not authenticate
You are probably signed in to TradeEasy with a different account in that browser. Sign in with your subscribed account and approve again. OAuth needs a browser; on a headless machine use a key instead.
My assistant says no tools are available
Switch the connector on in the chat’s tools menu (Claude) or the plus menu (ChatGPT); connectors are off by default in existing chats. In ChatGPT, check that Developer mode is still on. Then restart the client.
I get 401 or 403
The key was rotated or mistyped, or the plan lapsed. Rotate the key in your console and paste the new one. Rate limits apply per key. Still stuck? support@tradeeasyai.net
Which URL do I use?
https://api.tradeeasyai.net/public/v1/mcp in every client.
For brokers and institutions#
The MCP add-on is available on organization keys (scope mcp:query), so your own assistants, internal desks and client-facing copilots can call TradeEasy tools under one contract, with per-key rate limits and monthly usage reporting. Organization keys explains the scopes.
Educational market research, not investment advice; not for fully automated trade execution. Questions about the API or the MCP server: support@tradeeasyai.net.