tickerdb-mcp

TickerDB - Market context for agents.

Connect your agent to pre-computed market context that improves reasoning and reduces token usage.

Works with Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, LangChain, LlamaIndex, AutoGen, CrewAI, and any MCP-compatible client.

Setup

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp"],
      "env": {
        "TICKERDB_KEY": "tdb_your_api_key_here"
      }
    }
  }
}

Get an API key at tickerdb.com/dashboard.

Available Tools

Tool	Description
get_summary	Technical + fundamental summary for a single ticker (supports date range, events filtering, and MA distance lookbacks)
get_ohlcv	Paginated daily EOD candles for exact returns, charts, and backtests
get_search	Search assets by categorical state or rank snapshots by fields such as market_cap
get_schema	Discover available fields and filter options (always free, 0 credits)
get_watchlist	Live data for your saved watchlist tickers
get_watchlist_changes	Field-level diffs since the last pipeline run
add_to_watchlist	Add tickers to your watchlist
remove_from_watchlist	Remove tickers from your watchlist
get_account	Account details, plan tier, and usage
create_webhook	Register a webhook for watchlist changes
list_webhooks	List registered webhooks
delete_webhook	Remove a webhook

All tools are available on every tier (Free, Plus, Pro, Business). Tiers differ by credit limits, history depth, watchlist size, and webhook capacity. Business limits are per seat. See tickerdb.com/pricing for details.

Tools remain categorical-first for efficient LLM context. get_summary includes the same-candle ohlcv.open/high/low/close/volume, pattern setup states under patterns.bull_flag, patterns.bear_flag, triangle fields, wedge fields, and stock-only fundamentals such as fundamentals.free_cash_flow; use get_ohlcv when exact multi-bar daily history is needed, and follow next_cursor while has_more is true. OHLCV costs 1 credit per 100 bars returned, rounded up, with a 1 credit minimum. get_watchlist does not take a timeframe. Use get_watchlist_changes for daily or weekly diffs. Add stats=true in get_summary event mode when you want aggregate event-band and aftermath distributions instead of raw rows. Paid event aftermaths include exact close-to-close fields such as return_5d_pct, return_20d_pct, and return_100d_pct alongside the categorical performance bands. Incomplete horizons return null. get_summary keeps sibling _meta / status_meta objects off by default; pass meta: true when you want paid-tier stability metadata inline, or request explicit *_meta field paths. get_watchlist still includes paid-tier _meta objects by default.

MA distance fields are available throughout the stack:

• Use flat schema/search/event names like ma8, ma20, ma40, ma50, ma100, ma200, pattern_bull_flag, pattern_bear_flag, pattern_ascending_triangle, pattern_descending_triangle, pattern_symmetrical_triangle, pattern_rising_wedge, pattern_falling_wedge, trend_ma_crossover_event, trend_ma20_slope, trend_ma50_slope, trend_distance_ma8, trend_distance_ma20, trend_distance_ma40, trend_distance_ma50, trend_distance_ma100, and trend_distance_ma200.
• Summary snapshots expose nested MA distance bands under trend.distance_from_ma_band.ma_8 through ma_200, MA slope states under trend.ma_slopes.ma_8 through ma_200, plus trend.ma_compression_band and trend.ma_crossover_event.
• MA distance event queries support grouped band=above and band=below aliases in addition to granular values like proximity_above.

Fundamental bands follow the same naming pattern: use fundamentals.free_cash_flow in summary field selection and fundamentals_free_cash_flow in schema, search, watchlist change, and event queries.

Remote Server

You can also connect directly to the hosted MCP server at https://mcp.tickerdb.com with your API key as a Bearer token, without installing this package.

Documentation

Full API docs and endpoint details at tickerdb.com/docs.