Endpoint
Hyperodds runs a read-only Model Context Protocol server. Agents can list every HIP-4 market, read merged books across deployers, fetch fair lines and get the most recently listed markets. No tool can trade, sign or access an account.
https://api.usehyperodds.com/mcp
Transport: Streamable HTTP (JSON-RPC over POST), stateless. No sign-up or key. Each client, identified by its IP address, gets a free daily allowance of tool calls. The exact number is in the instructions the server sends when your client connects. It resets at 00:00 UTC, and a call over it gets an error that names the limit and when it resets.
Tools
| Tool | Output | Input |
|---|---|---|
odds_markets | HIP-4 markets with bid, ask, fair line, best edge after fees, 24h volume, settlement time and status. | category, deployer, sort (edge, volume, new, settling), q (search text), limit (up to 100) |
odds_cluster | The same question listed by several deployers: members, grades, rule differences and the merged book. | id (cluster id) or outcome (any member) |
odds_fair | One market's fair line: probability, band, method, every source with its age, and confidence. | outcome |
odds_new | The newest listings, newest first, with the same fields as odds_markets. | category, limit (up to 100) |
Connect a client
Most MCP clients take a JSON entry like this:
{
"mcpServers": {
"hyperodds": {
"type": "http",
"url": "https://api.usehyperodds.com/mcp"
}
}
}Reading the numbers
Prices are decimals from 0 to 1 for the market's first side, the first label in sides (often Yes). Edges are in percentage points after every fee, calculated for a $100 order, so 2.9 means 2.9¢ a share. Fair lines are estimates, and a Same grade means no difference was found in the rules.