# TickerDB

Hands your agent named market states instead of raw candles: RSI zones, trend direction, support levels and what followed similar setups.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: tickerdb
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tickerdb/tickerdb-mcp
- Updated: 2026-09-04
- HTML: https://affpapa.org/en/nevibecode/mcp/tickerdb

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.tickerdb.com/mcp`
- Environment variables: `TICKERDB_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.tickerdb.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env TICKERDB_KEY=<TICKERDB_KEY> --transport stdio tickerdb -- npx -y tickerdb-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add tickerdb --url https://mcp.tickerdb.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add tickerdb --env TICKERDB_KEY=<TICKERDB_KEY> -- npx -y tickerdb-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tickerdb": {
            "url": "https://mcp.tickerdb.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tickerdb": {
            "command": "npx",
            "args": [
                "-y",
                "tickerdb-mcp"
            ],
            "env": {
                "TICKERDB_KEY": "<TICKERDB_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tickerdb": {
            "type": "http",
            "url": "https://mcp.tickerdb.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tickerdb": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "tickerdb-mcp"
            ],
            "env": {
                "TICKERDB_KEY": "<TICKERDB_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http tickerdb https://mcp.tickerdb.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e TICKERDB_KEY=<TICKERDB_KEY> tickerdb npx -y tickerdb-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Show me oversold large-cap stocks near support
- What usually happens when AAPL goes oversold?
- What changed on my watchlist this week?

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md