Tiingo Mcp

tiingo-mcp

[](https://pypi.org/project/tiingo-mcp/) [](https://pypi.org/project/tiingo-mcp/) [](LICENSE) [](https://github.com/wshobson/tiingo-mcp/actions/workflows/ci.yml)

An MCP server that wraps the Tiingo financial data API. Covers stocks, forex, crypto, news, fundamentals, and corporate actions across 17 tools, 4 resources, and 5 prompts.

Installation

uvx tiingo-mcp
# or
pip install tiingo-mcp

Requires Python 3.12+.

Configuration

export TIINGO_API_KEY="your-api-key-here"

Free API keys at api.tiingo.com. The free plan covers stocks, forex, crypto, news, and fundamentals. Dividends and splits endpoints need a Power or Business plan.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "tiingo": {
      "command": "uvx",
      "args": ["tiingo-mcp"],
      "env": {
        "TIINGO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add tiingo -- uvx tiingo-mcp

Other Clients

Anything that speaks stdio:

TIINGO_API_KEY=your-key tiingo-mcp

Tools

Stocks (EOD)

| Tool | Description | |------|-------------| | get_stock_metadata | Ticker info — name, exchange, description, date range | | get_stock_prices | Historical EOD OHLCV with adjusted prices |

Real-Time & Intraday (IEX)

| Tool | Description | |------|-------------| | get_realtime_price | Current IEX top-of-book quote | | get_intraday_prices | Intraday prices at 1min–1hour intervals |

Forex

| Tool | Description | |------|-------------| | get_forex_quote | Current top-of-book rate | | get_forex_prices | Historical forex prices |

Crypto

| Tool | Description | |------|-------------| | get_crypto_quote | Current prices (2,100+ tickers) | | get_crypto_prices | Historical crypto prices | | get_crypto_metadata | Ticker metadata and supported exchanges |

News

| Tool | Description | |------|-------------| | get_news | Search financial articles by ticker, tag, source, date |

Fundamentals

| Tool | Description | |------|-------------| | get_fundamentals_definitions | Metric definitions | | get_financial_statements | Income statements, balance sheets, cash flow | | get_daily_fundamentals | Daily metrics — market cap, P/E, EV/EBITDA | | get_company_meta | Sector, industry, location |

Corporate Actions

| Tool | Description | |------|-------------| | get_dividends | Dividend and distribution history | | get_dividend_yield | Dividend yield history | | get_splits | Stock split history |

\ Requires Power or Business plan*

Resources

Static reference data exposed as browsable MCP resources. No API calls consumed.

| Resource | Description | |----------|-------------| | tiingo://capabilities | Server capabilities, asset classes, rate limits, plan restrictions | | tiingo://fundamentals/definitions | Curated reference of 20 key fundamental metrics | | tiingo://guide/date-formats | Date formats, resample frequencies, sort options | | tiingo://guide/{asset_class} | Usage guide per asset class (stocks, forex, crypto, news, fundamentals, corporate-actions) |

Prompts

Reusable workflow templates that guide LLMs through multi-step financial analysis.

| Prompt | Arguments | Description | |--------|-----------|-------------| | analyze-stock | ticker, include_news | Comprehensive single-stock analysis | | compare-stocks | ticker1, ticker2, period | Side-by-side stock comparison | | crypto-market-overview | tickers | Crypto market snapshot with 7-day trends | | earnings-report-analysis | ticker, earnings_date | Earnings report with price reaction and news | | forex-pair-analysis | pair, period | Currency pair trend and volatility analysis |

Parameters

Dates are YYYY-MM-DD format.

| Parameter | Used By | Description | |-----------|---------|-------------| | start_date | Most tools | Start of date range | | end_date | Most tools | End of date range | | resample_freq | Price tools | daily, weekly, monthly, annually, 1min, 5min, 1hour, etc. | | tickers | Crypto, news, meta | Comma-separated list |

Rate Limits

| Plan | Requests/Hour | Requests/Day | |------|---------------|--------------| | Free | 50 | 1,000 | | Power | 5,000 | 50,000 | | Business | Higher | Higher |

The server retries transient errors (2x) and returns JSON error objects for rate limits (429), auth failures (401), plan restrictions (403), and bad tickers (404).

Development

git clone https://github.com/wshobson/tiingo-mcp.git
cd tiingo-mcp
uv sync

# Unit tests (no API key needed)
uv run pytest tests/test_client.py tests/test_server.py -v

# Integration tests (needs TIINGO_API_KEY)
uv run pytest tests/test_integration.py -v -s

# All tests
uv run pytest -v

# Lint & format
uv run ruff check src/ tests/
uv run ruff format src/ tests/

License

[MIT](LICENSE)

Links

• Tiingo API docs
• Model Context Protocol
• FastMCP

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: major7apps
• Source: major7apps/tiingo-mcp
• License: MIT
• Homepage: https://pypi.org/project/tiingo-mcp/

Install and usage instructions live in the source repository linked above.