Content
# DepthFeed MCP Server
**Give Claude, Cursor, Codex, and ChatGPT live prediction-market order-book data.**
[DepthFeed](https://depthfeed.com) runs a remote [Model Context Protocol](https://modelcontextprotocol.io) (MCP)
server so AI agents can pull **Polymarket, Kalshi, and Limitless** order-book depth and price
data straight into a session — no SDK, no glue code. Listed in the official MCP registry as
[`com.depthfeed/depthfeed`](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.depthfeed/depthfeed).
```
https://api.depthfeed.com/mcp
```
It's a **remote, Streamable-HTTP** server and **keyless to start**: add the endpoint and your
agent can query BTC Polymarket markets immediately. Add a [DepthFeed API key](https://depthfeed.com)
(`Authorization: Bearer df_…`) to unlock all 7 assets (BTC/ETH/SOL/XRP/DOGE/BNB/HYPE), Kalshi,
Limitless, the full order-book ladder, and deep history — the same plan gating as the REST API.
## Install
**Claude Code**
```bash
claude mcp add --transport http depthfeed https://api.depthfeed.com/mcp
# with a key:
claude mcp add --transport http depthfeed https://api.depthfeed.com/mcp \
--header "Authorization: Bearer df_YOURKEY"
```
**Cursor** — `~/.cursor/mcp.json` (or `.cursor/mcp.json`)
```json
{ "mcpServers": { "depthfeed": { "url": "https://api.depthfeed.com/mcp" } } }
```
**VS Code (Copilot agent mode)**
```bash
code --add-mcp '{"name":"depthfeed","type":"http","url":"https://api.depthfeed.com/mcp"}'
```
**Claude Desktop** — Settings → Connectors → Add custom connector → paste the URL.
**ChatGPT** — Settings → Connectors → enable Developer Mode → add the URL.
**OpenAI Codex** — `~/.codex/config.toml`
```toml
[mcp_servers.depthfeed]
url = "https://api.depthfeed.com/mcp"
# bearer_token_env_var = "DEPTHFEED_TOKEN" # optional, for a key
```
Any MCP-capable client works (Windsurf, Cline, Zed, …) — add `https://api.depthfeed.com/mcp`
as a remote/custom MCP server.
## Tools
All tools are **read-only** and return the same JSON as the [DepthFeed REST API](https://depthfeed.com/docs).
| Tool | Returns |
|---|---|
| `polymarket_all_markets` | All currently discoverable Polymarket markets across supported assets |
| `polymarket_search_markets` | Polymarket up/down crypto markets for a coin |
| `polymarket_get_market` | A single Polymarket market by id or slug |
| `polymarket_get_snapshots` | Polymarket order-book history (time series) |
| `kalshi_search_markets` | Kalshi crypto markets *(paid)* |
| `kalshi_get_orderbook` | Latest Kalshi yes/no depth by ticker *(paid)* |
| `kalshi_get_snapshots` | Kalshi yes/no depth history *(paid)* |
| `limitless_search_markets` | Open Limitless markets on Base *(paid)* |
| `limitless_get_orderbook` | Latest Limitless L2 depth by slug *(paid)* |
| `limitless_get_snapshots` | Limitless L2 depth history *(paid)* |
| `screener` | Cross-venue top-of-book snapshot for all assets |
| `whoami` | The session's plan, limits, and coin access |
## Live example (no key)
```bash
# List tools
curl -sS https://api.depthfeed.com/mcp -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Keyless BTC Polymarket markets
curl -sS https://api.depthfeed.com/mcp -H 'content-type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"polymarket_search_markets","arguments":{"coin":"btc","limit":3}}}'
```
## Links
- Website: <https://depthfeed.com>
- MCP landing page: <https://depthfeed.com/mcp>
- Guide: <https://depthfeed.com/resources/prediction-market-mcp-server>
- API docs: <https://depthfeed.com/docs>
- Python clients: [polymarket-price-data](https://github.com/vcorp-dev/polymarket-price-data) · [kalshi-price-data](https://github.com/vcorp-dev/kalshi-price-data)
## Contributing and support
- Propose documentation or integration improvements in [CONTRIBUTING.md](./CONTRIBUTING.md).
- Ask usage questions through [DepthFeed support](https://depthfeed.com/contact).
- Report security concerns privately using [SECURITY.md](./SECURITY.md).
---
Independent research project. Not affiliated with or endorsed by Polymarket, Kalshi,
Limitless, Binance, or any exchange.