@seekingdata/mcp

An MCP server for seekingdata. It gives an assistant typed tools to query live, fully sourced market data — crypto, FX, equities, commodities, macro, and more — organized as Category → Product → Metric. Every response includes its source and timestamp, so answers are auditable.

Install

Add it to any MCP client (Claude Code, Claude Desktop, and others). The catalog and provenance tools need no key:

claude mcp add seekingdata -- npx -y @seekingdata/mcp

For the data tools, pass a seekingdata API key. A free key is available at seekingdata.dev:

claude mcp add seekingdata --env SEEKINGDATA_API_KEY=<key> -- npx -y @seekingdata/mcp

That's the whole setup — the server uses the hosted API at https://api.seekingdata.dev.

Tools

| Tool | Key | Answers | |---|:---:|---| | browse_catalog | – | What data is available: categories, products, metrics, plan tiers, and (with a key) what your plan can access. | | get_metric | ✓ | The value of any metric for a given entity, source, and time window — across every category. | | reference_price | ✓ | The current cross-venue reference price for a symbol. | | ohlcv | ✓ | Recent 1s or 1m candles for a symbol. | | recent_trades | ✓ | The most recent trade prints for a symbol. | | option_chain | ✓ | The live option chain for an underlying. | | sources | – | Which exchanges, providers, and agencies the data comes from. | | provenance | – | How each metric is derived. |

reference_price, ohlcv, recent_trades, and option_chain are typed shortcuts over the same call get_metric makes; get_metric reaches every live category. browse_catalog, sources, and provenance are always keyless.

List tools accept max_response_tokens and cursor. When a response is trimmed to fit the budget it reports meta.truncated, meta.returned, meta.has_more, and meta.next_cursor so you can page through with cursor.

The category, product, metric, and source arguments are built from the live catalog when the server starts, so new categories show up without a package update. entity (the symbol, underlying, or ticker a call is about) is free text.

Resources

| URI | Returns | |---|---| | seekingdata://catalog | The full data catalog. | | seekingdata://sources | The source registry. | | seekingdata://category/{category} | One category's detail. |

Auth

Set SEEKINGDATA_API_KEY to use the keyed tools; it is sent as a bearer token. A missing key fails immediately with a message explaining how to set it — no wasted network call. A rejected key (401) or a plan tier too low for a metric (403) returns a clear error that names the required tier; call browse_catalog to check a metric's tier first.

Configuration

| Variable | Default | Purpose | |---|---|---| | SEEKINGDATA_API_KEY | – | Your API key. Required for the data tools; not for browse_catalog, sources, or provenance. | | SEEKINGDATA_API_TIMEOUT_MS | 10000 | Per-request timeout, in milliseconds. |

Links

• Website and API keys: seekingdata.dev
• API reference: api.seekingdata.dev/openapi.json