TickerDB — Claude Code MCP server: what it does, how to install
Hands your agent named market states instead of raw candles: RSI zones, trend direction, support levels and what followed similar setups.
claude mcp add --transport http mcp-server https://mcp.tickerdb.com/mcpWhat TickerDB does
TickerDB is an MCP server serving pre-computed market data. The agent reads categorical states such as trend_direction, support_level and analyst_consensus rather than crunching indicators from price bars. Coverage spans US stocks, ETFs and crypto pairs, with 182 fields and 7 years of history.
Nine tools ship with it. get_summary returns a technical and fundamental snapshot for one ticker, get_ohlcv serves daily or weekly end-of-day candles, get_search screens assets by state or ranks them by market_cap and pe_ratio, and get_schema lists every field with its valid bands. Watchlist work has its own set: get_watchlist, get_watchlist_changes, add_to_watchlist, remove_from_watchlist. Every tool is open on all tiers; tiers differ in credit limits, history depth, filter count and watchlist size.
Two transports exist. The hosted endpoint https://mcp.tickerdb.com/mcp speaks Streamable HTTP with OAuth 2.1 or a Bearer token. The npm package tickerdb-mcp runs locally through npx and reads its key from TICKERDB_KEY. Only initialize and tools/list work unauthenticated — a tools/call comes back as 401. Access control and rate limiting live in the TickerDB API, so the server itself stays a thin proxy.
What it helps with
- see what a stock usually did after RSI entered oversold
- screen large caps sitting near support while oversold
- review which watchlist states shifted week over week
- pull daily candles for a backtest or chart
- discover which fields and band values the API exposes
Example prompts for the agent
- Show me oversold large-cap stocks near support
- What usually happens when AAPL goes oversold?
- What changed on my watchlist this week?
How to install TickerDB
1Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.tickerdb.com/mcp2Platform CLI
claude mcp add --env TICKERDB_KEY=<TICKERDB_KEY> --transport stdio tickerdb -- npx -y tickerdb-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add tickerdb --url https://mcp.tickerdb.com/mcp2Platform CLI
codex mcp add tickerdb --env TICKERDB_KEY=<TICKERDB_KEY> -- npx -y tickerdb-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"tickerdb": {
"url": "https://mcp.tickerdb.com/mcp"
}
}
}{
"mcpServers": {
"tickerdb": {
"command": "npx",
"args": [
"-y",
"tickerdb-mcp"
],
"env": {
"TICKERDB_KEY": "<TICKERDB_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tickerdb": {
"type": "http",
"url": "https://mcp.tickerdb.com/mcp"
}
}
}{
"servers": {
"tickerdb": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tickerdb-mcp"
],
"env": {
"TICKERDB_KEY": "<TICKERDB_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http tickerdb https://mcp.tickerdb.com/mcp2Platform CLI
gemini mcp add -e TICKERDB_KEY=<TICKERDB_KEY> tickerdb npx -y tickerdb-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about TickerDB
How do I install TickerDB in Claude Code?
For the hosted server run claude mcp add --transport http tickerdb https://mcp.tickerdb.com/mcp. For the local npm package run claude mcp add --env TICKERDB_KEY=<TICKERDB_KEY> --transport stdio tickerdb -- npx -y tickerdb-mcp.
What does TickerDB do?
It gives an agent pre-computed market states for US stocks, ETFs and crypto pairs: trend, momentum, volatility, volume, support and resistance, fundamentals. It also returns state transitions and the historical aftermath of those states across 7 years.
Does TickerDB need an API key?
The hosted server accepts OAuth 2.1 or a Bearer token starting with tdb_. The local npm package needs a key in the TICKERDB_KEY environment variable, available from the TickerDB dashboard.
