Content
# dino-markets-mcp
Stdio bridge for [dino.markets](https://dino.markets) — **matched Kalshi + Polymarket prediction-market
data** for AI agents. The same event matched across both venues, cross-venue spreads, and confirmed
arbitrage sized to fillable depth, for Claude, Cursor, and any MCP (Model Context Protocol) client.
Market data only — not a broker; not financial advice.
Thin proxy: the bridge holds no tool definitions or schemas. Every tool is served live from the
`api.dino.markets` HTTP MCP endpoint, so descriptions and schemas are always up to date.
Prefer a remote connection? The server also runs directly at `https://api.dino.markets/v2/mcp/`
(streamable HTTP) and is listed in the [official MCP registry](https://registry.modelcontextprotocol.io)
as `markets.dino/mcp` — no install needed:
```bash
claude mcp add --transport http dino-markets https://api.dino.markets/v2/mcp/
```
## Quick start
```json
{
"mcpServers": {
"dino-markets": {
"command": "npx",
"args": ["-y", "dino-markets-mcp"],
"env": { "DINO_API_KEY": "your-key-here" }
}
}
}
```
An API key is required. Get one at https://dino.markets/pricing — the Free tier includes MCP access.
## Tools
| Tool | What it does |
|---|---|
| `find_markets` | free-text lookup by team, competition, context, or market title |
| `list_markets` | the matched cross-venue catalog as canonical Market objects, filterable by category |
| `find_arbitrage` | confirmed cross-venue Opportunity objects, filterable by sport |
| `get_market` | one market by id, with settlement disclosure |
| `get_spreads` | cross-venue price gaps on matched pairs, with verified confidence |
| `list_categories` | normalized categories, market types, and contextual facets |
| `report_bad_arb` | flag an Opportunity that looks wrong |
| `watch_markets` | mint a ticket for the real-time WebSocket stream and return the `ws_url` |
## Env
| Variable | Required | Default | Description |
|---|---|---|---|
| `DINO_API_KEY` | Yes | — | Bearer token for API access. |
| `DINO_BASE_URL` | No | `https://api.dino.markets` | Override API origin (testing / staging). |
| `DINO_TIMEOUT` | No | `10000` | Request timeout in milliseconds. |
## Development
```bash
npm install
npm run build # tsc -> dist/
```
## Docs
Full API reference and pricing: [dino.markets/docs](https://dino.markets/docs) — REST and WebSocket
are also available if you'd rather skip MCP, with the OpenAPI spec at
[api.dino.markets/openapi.json](https://api.dino.markets/openapi.json).
MIT © Nusantara Ventures LLC
