Agent Connections
All MCP setup starts in the dashboard:
app.tradeecho.com/agent-connections
You need an active Trade Echo subscription.
Create a personal access token (PAT)
- Open Agent Connections.
- Enter a label (e.g.
Cursor laptop,Claude Code). - Choose an access profile:
- Core Market Intel - flow, dealer edge, dark pool, algo edge, news, market, multi-signal
- Options & Dealer Intel - flow, dealer edge, market / chains
- Full Trade Echo Intel - every read-only MCP tool
- Or toggle custom tools individually
- Accept the MCP terms.
- Click Create.
- Copy the token immediately - Trade Echo will not show it again.
Token format looks like te_live_....
MCP URL (same for everyone):
https://api.tradeecho.com/api/mcp/intel
Auth types
| Type | Best for | How |
|---|---|---|
| PAT | Cursor, Claude Code, Codex, Grok, Claude Desktop | Create token → paste Bearer header |
| OAuth | ChatGPT Developer mode | Add MCP URL → ChatGPT opens Trade Echo consent → Allow |
OAuth connections also appear on the Agent Connections list as type oauth. Revoke them the same way as PATs.
ChatGPT does not support pasting a PAT. Use OAuth from the ChatGPT connector flow.
Credits and limits
MCP usage is metered in credits. Limits reset on the clock hour.
Typical defaults:
| Bucket | Limit |
|---|---|
| Per connection / hour | 100 credits |
| Per user / hour | 150 credits |
| Burst / minute | 15 credits |
Heavy tools (e.g. dealer edge, options chain, filings) cost more credits than a simple flow query. Usage shows on each connection row.
If you hit the hourly cap:
- Wait for the next hour, or
- Buy a bonus credit pack on the same page (Starter / Agent Day / Power Week)
Bonus credits apply after the hourly pool is exhausted. Revoking or creating a new token does not reset your hourly usage.
Daily create caps apply (PAT + OAuth) so tokens are not mass-minted.
Manage connections
On the right side of Agent Connections you can:
- See active vs revoked connections
- Watch hourly usage + bonus credits
- Revoke a connection (click once to arm, again to confirm)
After revoke, that PAT or OAuth grant stops working immediately for tools/list and tools/call.
Scopes vs tools (short map)
| Scope | Example tools |
|---|---|
flow.read | get_option_flow, get_option_flow_sector_summary |
dealer_edge.read | get_dealer_edge_data |
darkpool.read | get_dark_pool_data |
algo_edge.read | get_algo_edge_signals |
news.read | get_news |
market.read | get_market_data, get_index_snapshot, get_macro_events, get_options_chain_snapshot |
intel.read | get_bt_cloud_state, multi_signal_scan |
filings.read | get_sec_filings, get_company_financials |
Only tools allowed by the connection's scopes appear in tools/list.