MCP

Hosted research engine MCP

Let Cursor, VS Code, and other MCP clients run the same analysis jobs, watchlist, credits, and simulated trading as the desk. Add a URL, then sign in. Do not put tokens in the config file.

Add to Cursor Install in VS Code All clients

Transport: Streamable HTTP
Sign-in: Desk OAuth · PKCE
Tools: 27 desk tools

Same desk, from an editor

The MCP endpoint runs on the research desk Node BFF. Tools call the same /api routes, with the same user, credit gate, and paper-trading flag. Analysis is async: start_analysis returns an id; poll get_analysis; then get_analysis_report. This is not a live broker and not a TradingView market-data clone.

Install in one click or one command

Cursor and VS Code can add the server without editing JSON. Other clients paste the hosted URL. The first connection opens the desk sign-in, then a consent page.

One click

Cursor

Opens Cursor and adds the hosted server. Sign in with the same desk account when prompted.

Add to Cursor

One click

VS Code

Opens VS Code and adds the server. Use Copilot Agent mode after sign-in.

Install in VS Code VS Code Insiders

Paste URL

Claude Desktop / claude.ai

Customize → Connectors → Add custom connector. Paste the hosted URL, then sign in.

Open Claude Connectors →

MCP URL

https://mcp.tradingagentsreport.com/mcp

CLI clients

Copy the command, then finish desk sign-in in the client.

Claude Code

claude mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

Then run /mcp in the session and finish the browser login.

Codex

codex mcp add tradingagents-report --url https://mcp.tradingagentsreport.com/mcp
codex mcp login tradingagents-report

The second line opens the desk in the browser.

Gemini CLI

gemini mcp add --transport http tradingagents-report https://mcp.tradingagentsreport.com/mcp

If Gemini asks to authenticate, run /mcp auth tradingagents-report.

Other clients and JSON configs

Use these when the client has no install link or CLI. Older clients may use streamable-http instead of http. The URL is the same. Do not add Authorization headers; OAuth supplies the token.

mcpServers

{
  "mcpServers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Cursor: ~/.cursor/mcp.json. Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json.

VS Code · servers

{
  "servers": {
    "tradingagents-report": {
      "type": "http",
      "url": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Workspace: .vscode/mcp.json. VS Code uses servers, not mcpServers.

VS Code CLI

code --add-mcp '{"name":"tradingagents-report","type":"http","url":"https://mcp.tradingagentsreport.com/mcp"}'

Windsurf

{
  "mcpServers": {
    "tradingagents-report": {
      "serverUrl": "https://mcp.tradingagentsreport.com/mcp"
    }
  }
}

Windsurf: ~/.codeium/windsurf/mcp_config.json. The remote field is serverUrl, not url.

What the tools cover

Twenty-seven tools forward desk APIs. Analysis jobs stay asynchronous. Quotes and news are desk snapshots, not a full indicator pack. Simulated orders debit product credits as fees and never reach a broker.

Analysis jobs

Submit a ticker, poll progress, read the decision card and report, list history, or cancel. Credits are checked before start.

Market snapshots

Resolve a listing, then quote, OHLCV, session snapshot, news, and company identity. Full statements live on completed reports.

Watchlist

List, add, or remove the signed-in user's watchlist. Adding can take a ticker and resolve the listing first.

Credits and plan

Read period and bonus balances, invoices, and whether a new analysis can start. Checkout stays in the browser.

Simulated trading

Open the paper account, read equity and fills, claim check-in, and place or cancel simulated orders. Feature-flagged; not live execution.

Research

resolve_listing

Normalize a ticker into exchange, symbol, and provider_symbol.

Research

start_analysis

Submit an async research job and return its id immediately.

Research

get_analysis

Job status and progress. Use get_analysis_report after success.

Research

get_analysis_events

Stage timeline for a running or finished job.

Research

get_analysis_report

Decision card and report sections after the job succeeded.

Research

list_analyses

List the signed-in user's recent analysis jobs.

Research

cancel_analysis

Request cancellation of a queued or running job.

Credits

estimate_analysis

Check whether credits cover the start threshold.

Market

get_quote

Latest quote for an EXCHANGE:SYMBOL ticker.

Market

get_ohlcv

OHLCV bars. Timeframe defaults to D.

Market

get_ta_summary

Snapshot of last price, session, and identity. Not a full TA pack.

Market

get_news

get_fundamentals

Company name, exchange, and logo. Statements are on reports.

Watchlist

list_watchlist

List watchlist rows for the signed-in user.

Watchlist

add_watchlist_item

Add a listing. A ticker is enough; the tool resolves the rest.

Watchlist

remove_watchlist_item

Remove a watchlist row by id.

Credits

get_usage

Period credits, bonus credits, and this cycle's ledger.

Credits

get_subscription

Current plan, pending change, and invoices. Read-only.

Paper

open_paper_account

Open the default $10,000 simulated account, or return it.

Paper

get_paper_account

Cash, equity, P&L, and open positions.

Paper

list_paper_orders

Paper orders for the default or given account.

Paper

list_paper_fills

Paper fills (executions).

Paper

list_paper_cash_ledger

Opening grant, check-in, and cash adjustments.

Paper

get_paper_checkin

Daily simulated-USD check-in status.

Paper

claim_paper_checkin

Claim today's simulated-USD check-in.

Paper

place_paper_order

Place a simulated market or limit order. Not a live broker.

Paper

cancel_paper_order

Cancel a pending or triggered paper order.

Ask the assistant

After sign-in, restart is usually unnecessary. Try prompts that map to a tool.

Analyze NASDAQ:AAPL for today with market, news, and fundamentals.
What is on my watchlist, and which names have open paper positions?
How many credits do I have, and can I start two analyses?
Get the latest quote and recent news for HKEX:700.
Open my paper account if needed and show cash and equity.
Place a paper buy of 10 shares of NASDAQ:AAPL at market.

Sign in on the desk

The first connection opens the research desk sign-in, then a consent page. Use the same account as the web desk. Operators do not enable Clerk Dashboard OAuth applications or Dynamic Client Registration. If the embedded browser cannot sign in, copy the link into the system browser.

What this MCP is not

The hosted MCP is a desk adapter. It inherits product limits.

It does not place live broker orders or hold real cash.
It does not start Stripe Checkout or the customer portal.
It does not expose admin, queue, or API-key tools.
Paper trading can be off; then those tools return PAPER_FEATURE_DISABLED.
Analysis still spends credits on the same ledger as the web desk.

For deeper quotes, screeners, and calendars, pair this with TradingView MCP. This endpoint is the research engine, not a second market-data MCP. TradingView MCP

Open the research desk Add to Cursor

MCP FAQ

Common questions about the hosted MCP

Do I put an API key in the MCP config?

No. Cursor, VS Code, and CLI clients add only the URL. Sign-in on the desk issues a short-lived access token. Do not paste Clerk, Stripe, or Core keys.

Which account is used?

The same desk account you use in the browser. Watchlist, jobs, credits, and paper trading are that user's data.

How do analysis jobs work over MCP?

start_analysis returns an id immediately. Poll get_analysis until status is succeeded, then call get_analysis_report. Do not treat the start call as a finished report.

Can the assistant trade for me?

Only simulated orders, and only when Simulated Trading is enabled. Fees debit product credits. Nothing is sent to a broker.