tradeiq-mcp

An MCP (Model Context Protocol) server that gives Claude, Codex CLI and other MCP clients real, point-in-time market data — prices, indicators, fundamentals, SEC filings, news, insider activity, options, earnings dates, macro series — plus tools to turn an analysis into a professionally formatted report (PDF, HTML, Word or Markdown) and to keep a verifiable track record of your calls.

It runs locally on your machine over stdio. No account and no hosted backend of its own; most data tools need no API key (macro series need a free FRED key).

Educational and informational use only. Nothing here is investment advice.

Install

You need uv. Then add the server to your client:

Claude Code

claude mcp add tradeiq -- uvx tradeiq-mcp

Claude Desktop — add to claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "tradeiq": { "command": "uvx", "args": ["tradeiq-mcp"] }
  }
}

Codex CLI

codex mcp add tradeiq -- uvx tradeiq-mcp

Restart the client, then ask for something like "Research MSFT and give me a full report as a PDF."

Prefer pip? pip install tradeiq-mcp, then use tradeiq-mcp as the command.

How it works: your assistant does the thinking

Most tools here only fetch and verify data — there is no LLM inside them. The analysis (bull case, bear case, verdict) is written by the assistant you already use, on your own subscription, using verified data as input. That keeps this free to run and keeps every number traceable to a real source and date.

Every data tool takes an as_of_date and never returns anything after it, so an analysis "as of" a past date sees only what was actually knowable then. Live-only sources with no history (earnings calendar, options chains) are withheld for past dates rather than served mislabeled.

Tools

Data and research — no API key, no LLM cost

Reports and track record

Optional automated pipeline — needs your own LLM API key

These make many LLM calls per run using your provider API key, set as an environment variable for the server (for example OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY). A Claude or ChatGPT subscription is not an API key and cannot be used for this. Everything else works without one.

Pass keys through your client's config, e.g. Claude Code:

claude mcp add tradeiq -e ANTHROPIC_API_KEY=... -- uvx tradeiq-mcp

Where data is written

Reports, exports and the decision log are written under ~/.tradingagents/ on your machine (override with TRADINGAGENTS_RESULTS_DIR and TRADINGAGENTS_MEMORY_LOG_PATH). The server has no backend of its own to send them to; its outbound requests go to the market-data sources the tools query, and to your LLM provider if you use the optional pipeline.

PDF export on Linux and macOS

PDF export uses WeasyPrint, which needs the Pango system library on Linux and macOS (Linux: libpango-1.0-0 and libpangoft2-1.0-0; macOS: brew install pango). HTML, Word and Markdown export work without it, and the server starts either way.

Development

python -m venv .venv
.venv/bin/python -m pip install -e .      # Windows: .venv\Scripts\python.exe
.venv/bin/python scripts/smoke_test.py    # exercises the tools end to end

Third-party code

This package bundles third-party open-source code under its own license. See NOTICE.

License

Apache-2.0 — see LICENSE.