# 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