ParlayAPI is an MCP server published by io.github.JacobiusMakes, hosted at parlay-api.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 22 tools, including parlayapi_signup, parlayapi_checkout_link, parlayapi_magic_link, parlayapi_get_pricing, parlayapi_live_sports.
Sports odds, player props and source coverage for AI assistants. Connect with your own API key.
2 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Create a free-tier ParlayAPI account for the given email. Returns the API key, a magic-login URL the user can click to access their dashboard, and a Stripe upgrade URL. Idempotent: if the email already has an account, returns exists=true with the login URL only (the existing API key is intentionally NOT exposed for security). Use this when a user wants to start building with ParlayAPI and does not have a key yet. After signup, ask the user to add the returned api_key to their MCP server config under PARLAYAPI_KEY, then restart the MCP client to pick it up. Args: email: User's email address. intended_use: Optional one-line description of what they're building. Used for analytics. agent_id: Identifier for the agent making the call. Defaults to "mcp-client".
| Parameter | Type | Description |
|---|---|---|
| email * | string | |
| agent_id | string | |
| intended_use | string |
{
"name": "parlayapi_signup",
"description": "Create a free-tier ParlayAPI account for the given email.\n\n Returns the API key, a magic-login URL the user can click to access\n their dashboard, and a Stripe upgrade URL. Idempotent: if the email\n already has an account, returns exists=true with the login URL only\n (the existing API key is intentionally NOT exposed for security).\n\n Use this when a user wants to start building with ParlayAPI and\n does not have a key yet. After signup, ask the user to add the\n returned api_key to their MCP server config under PARLAYAPI_KEY,\n then restart the MCP client to pick it up.\n\n Args:\n email: User's email address.\n intended_use: Optional one-line description of what they're\n building. Used for analytics.\n agent_id: Identifier for the agent making the call. Defaults\n to \"mcp-client\".\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_signupArguments",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"title": "Email"
},
"agent_id": {
"type": "string",
"title": "Agent Id",
"default": "mcp-client"
},
"intended_use": {
"type": "string",
"title": "Intended Use",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_signupDictOutput",
"additionalProperties": true
}
}Request an owner-authenticated checkout URL or an email-link flow. A configured key is forwarded for the backend to verify account ownership. With no matching key, the backend returns an email-flow acknowledgement rather than a checkout URL. That response does not confirm email delivery. Tiers: starter, pro, business, enterprise, scale. For current prices, call parlayapi_get_pricing.
| Parameter | Type | Description |
|---|---|---|
| tier | string | |
| email * | string |
{
"name": "parlayapi_checkout_link",
"description": "Request an owner-authenticated checkout URL or an email-link flow.\n\n A configured key is forwarded for the backend to verify account ownership.\n With no matching key, the backend returns an email-flow acknowledgement\n rather than a checkout URL. That response does not confirm email delivery.\n Tiers: starter, pro, business, enterprise, scale. For current prices, call\n parlayapi_get_pricing.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_checkout_linkArguments",
"required": [
"email"
],
"properties": {
"tier": {
"type": "string",
"title": "Tier",
"default": "pro"
},
"email": {
"type": "string",
"title": "Email"
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_checkout_linkDictOutput",
"additionalProperties": true
}
}Email a magic-login link for an existing ParlayAPI account. Always returns ok=true regardless of whether the email exists, to prevent account enumeration. The user receives the link by email.
| Parameter | Type | Description |
|---|---|---|
| email * | string |
{
"name": "parlayapi_magic_link",
"description": "Email a magic-login link for an existing ParlayAPI account.\n\n Always returns ok=true regardless of whether the email exists, to\n prevent account enumeration. The user receives the link by email.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_magic_linkArguments",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"title": "Email"
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_magic_linkDictOutput",
"additionalProperties": true
}
}Return the current public pricing table. No API key required. Use this when an agent needs to explain which tier unlocks a workflow before sending a checkout link.
No parameters.
{
"name": "parlayapi_get_pricing",
"description": "Return the current public pricing table.\n\n No API key required. Use this when an agent needs to explain which\n tier unlocks a workflow before sending a checkout link.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_get_pricingArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_get_pricingDictOutput",
"additionalProperties": true
}
}List currently active live sports on the retail /live surface. No API key required. Returns sport keys plus live event and book counts so agents can discover what is active right now.
No parameters.
{
"name": "parlayapi_live_sports",
"description": "List currently active live sports on the retail /live surface.\n\n No API key required. Returns sport keys plus live event and book\n counts so agents can discover what is active right now.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_live_sportsArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_live_sportsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
}
}Search live teams, players, and sport keys. No API key required. Useful when the user asks for a team, player, or league by natural-language name and the agent needs the exact sport_key to call next.
| Parameter | Type | Description |
|---|---|---|
| q * | string | |
| limit | integer |
{
"name": "parlayapi_live_search",
"description": "Search live teams, players, and sport keys.\n\n No API key required. Useful when the user asks for a team, player,\n or league by natural-language name and the agent needs the exact\n sport_key to call next.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_live_searchArguments",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"title": "Q"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_live_searchDictOutput",
"additionalProperties": true
}
}Return the public best-line command center payload. No API key required. Shows current games, participating books, and best available real prices on the /live dashboard preview. This is a discovery and demo surface, not a substitute for the paid odds endpoints.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| sport_key | string |
{
"name": "parlayapi_live_command_center",
"description": "Return the public best-line command center payload.\n\n No API key required. Shows current games, participating books, and\n best available real prices on the /live dashboard preview. This is\n a discovery and demo surface, not a substitute for the paid odds\n endpoints.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_live_command_centerArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 12
},
"sport_key": {
"type": "string",
"title": "Sport Key",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_live_command_centerDictOutput",
"additionalProperties": true
}
}Return public per-source freshness and quality metadata. No API key required. Use this to prove that rows are flowing from each source before choosing books for a customer workflow.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| minutes | integer |
{
"name": "parlayapi_source_quality",
"description": "Return public per-source freshness and quality metadata.\n\n No API key required. Use this to prove that rows are flowing from\n each source before choosing books for a customer workflow.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_source_qualityArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 40
},
"minutes": {
"type": "integer",
"title": "Minutes",
"default": 10
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_source_qualityDictOutput",
"additionalProperties": true
}
}Return public per-book coverage gates. No API key required. This is the proof surface for whether each source survives freshness, normalization, database, REST-shape, and stream-shape checks.
| Parameter | Type | Description |
|---|---|---|
| include_warn | boolean | |
| window_minutes | integer |
{
"name": "parlayapi_book_coverage",
"description": "Return public per-book coverage gates.\n\n No API key required. This is the proof surface for whether each\n source survives freshness, normalization, database, REST-shape, and\n stream-shape checks.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_book_coverageArguments",
"properties": {
"include_warn": {
"type": "boolean",
"title": "Include Warn",
"default": true
},
"window_minutes": {
"type": "integer",
"title": "Window Minutes",
"default": 15
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_book_coverageDictOutput",
"additionalProperties": true
}
}List available sport keys. Use these in subsequent calls. Examples: baseball_mlb, basketball_nba, americanfootball_nfl, icehockey_nhl, soccer_epl, mma_ufc, esports_lol, table_tennis_*.
| Parameter | Type | Description |
|---|---|---|
| active_only | boolean |
{
"name": "parlayapi_list_sports",
"description": "List available sport keys. Use these in subsequent calls.\n\n Examples: baseball_mlb, basketball_nba, americanfootball_nfl,\n icehockey_nhl, soccer_epl, mma_ufc, esports_lol, table_tennis_*.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_list_sportsArguments",
"properties": {
"active_only": {
"type": "boolean",
"title": "Active Only",
"default": true
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_list_sportsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Result"
}
}
}
}Get game-level odds for a sport from all configured bookmakers. Args: sport_key: e.g. "baseball_mlb", "soccer_epl" markets: Comma-separated. h2h, spreads, totals. regions: us, us2, uk, eu, fr, au, ca, mx, latam, br, asia. Comma-separated for multiple. bookmakers: Comma-separated bookmaker keys (optional). Examples: pinnacle, draftkings, fanduel, bovada, caesars. odds_format: decimal | american
| Parameter | Type | Description |
|---|---|---|
| markets | string | |
| regions | string | |
| sport_key * | string | |
| bookmakers | string | |
| odds_format | string |
{
"name": "parlayapi_get_odds",
"description": "Get game-level odds for a sport from all configured bookmakers.\n\n Args:\n sport_key: e.g. \"baseball_mlb\", \"soccer_epl\"\n markets: Comma-separated. h2h, spreads, totals.\n regions: us, us2, uk, eu, fr, au, ca, mx, latam, br, asia. Comma-separated for multiple.\n bookmakers: Comma-separated bookmaker keys (optional).\n Examples: pinnacle, draftkings, fanduel, bovada, caesars.\n odds_format: decimal | american\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_get_oddsArguments",
"required": [
"sport_key"
],
"properties": {
"markets": {
"type": "string",
"title": "Markets",
"default": "h2h"
},
"regions": {
"type": "string",
"title": "Regions",
"default": "us"
},
"sport_key": {
"type": "string",
"title": "Sport Key"
},
"bookmakers": {
"type": "string",
"title": "Bookmakers",
"default": ""
},
"odds_format": {
"type": "string",
"title": "Odds Format",
"default": "decimal"
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_get_oddsDictOutput",
"additionalProperties": true
}
}Get player prop odds for a sport. Args: sport_key: e.g. "baseball_mlb", "basketball_nba" markets: Comma-separated prop market keys (optional). Examples: player_points, player_rebounds, player_strikeouts, player_passing_yards, player_total_bases. bookmakers: Comma-separated. Examples: prizepicks, underdog, sleeper, draftkings, fanduel. player: Filter to props mentioning this player name. include_futures: Include season-long futures (default False).
| Parameter | Type | Description |
|---|---|---|
| player | string | |
| markets | string | |
| sport_key * | string | |
| bookmakers | string | |
| include_futures | boolean |
{
"name": "parlayapi_get_props",
"description": "Get player prop odds for a sport.\n\n Args:\n sport_key: e.g. \"baseball_mlb\", \"basketball_nba\"\n markets: Comma-separated prop market keys (optional).\n Examples: player_points, player_rebounds, player_strikeouts,\n player_passing_yards, player_total_bases.\n bookmakers: Comma-separated. Examples: prizepicks, underdog,\n sleeper, draftkings, fanduel.\n player: Filter to props mentioning this player name.\n include_futures: Include season-long futures (default False).\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_get_propsArguments",
"required": [
"sport_key"
],
"properties": {
"player": {
"type": "string",
"title": "Player",
"default": ""
},
"markets": {
"type": "string",
"title": "Markets",
"default": ""
},
"sport_key": {
"type": "string",
"title": "Sport Key"
},
"bookmakers": {
"type": "string",
"title": "Bookmakers",
"default": ""
},
"include_futures": {
"type": "boolean",
"title": "Include Futures",
"default": false
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_get_propsDictOutput",
"additionalProperties": true
}
}Find the best (highest) price for each outcome across bookmakers. Useful for line-shopping bots. Returns one row per game / market / side with the bookmaker offering the best price. Args: sport_key: e.g. "baseball_mlb" market: h2h | spreads | totals bookmakers: Restrict the search to these books (optional).
| Parameter | Type | Description |
|---|---|---|
| market | string | |
| sport_key * | string | |
| bookmakers | string |
{
"name": "parlayapi_best_line",
"description": "Find the best (highest) price for each outcome across bookmakers.\n\n Useful for line-shopping bots. Returns one row per game / market /\n side with the bookmaker offering the best price.\n\n Args:\n sport_key: e.g. \"baseball_mlb\"\n market: h2h | spreads | totals\n bookmakers: Restrict the search to these books (optional).\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_best_lineArguments",
"required": [
"sport_key"
],
"properties": {
"market": {
"type": "string",
"title": "Market",
"default": "h2h"
},
"sport_key": {
"type": "string",
"title": "Sport Key"
},
"bookmakers": {
"type": "string",
"title": "Bookmakers",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_best_lineDictOutput",
"additionalProperties": true
}
}Should I bet this? One-call verdict for a specific bet. Returns the no-vig fair price for the exact bet, the best available price and which book has it, how the user's price (if given) grades as EV, a line-shopping nudge, and a plain-English call: BET / LEAN / FAIR / PASS (or NO_DATA). Use this when a user asks whether a specific bet is worth making, or whether they're getting a good number, instead of stitching /ev + /consensus + /best-line yourself. The best-price / shop recommendation is scoped to books the user can bet at (default US, so a US bettor is never told to use a euro book). Set it once with parlayapi_set_bettable_books and it is remembered per key, or pass region / books here per call. Args: sport: sport_key, e.g. "baseball_mlb". side: the team you'd bet (h2h / spreads), or "over" / "under" (totals / props). market: h2h | spreads | totals | a player-prop key (player_hits, player_points, ...). home, away: the two teams, to identify the game. Or pass `team` with one name. team: one team name to find the game (alternative to home + away). player: player name (required for player-prop markets). line: the number for spreads, totals, or props. book: the book you'd bet at (grades that book's current price). price: the price you're offered (American like -110, or decimal like 1.91). Overrides `book`, use it to grade a specific number in hand. region: where you can bet: us (default) | eu | uk | au | ca. books: exact CSV of books you can bet at (overrides region; use for state-level geo-blocks, e.g. "draftkings,fanduel,novig"). bankroll: the user's bankroll; when the bet is +EV, returns a suggested Kelly stake amount ("bet it, ~$X"). kelly: Kelly fraction (default 0.5 = half-Kelly, the bankroll-safe standard). The response also carries an `edge_alert` when a book shows a price far better than the market (a possible soft error worth grabbing, or a stale line to verify) that the normal best-price guard would otherwise hide.
| Parameter | Type | Description |
|---|---|---|
| away | string | |
| book | string | |
| home | string |
Remember which books the user can bet at, so parlayapi_verdict scopes its best-price and shop recommendations to them automatically (no need to pass region/books every call). Call this once when a user tells you where they bet ("I'm in the US on DraftKings and FanDuel"). Pass region OR an exact books list. Args: region: us | eu | uk | au | ca. books: exact CSV of book keys, e.g. "draftkings,fanduel,novig". Overrides region.
| Parameter | Type | Description |
|---|---|---|
| books | string | |
| region | string |
{
"name": "parlayapi_set_bettable_books",
"description": "Remember which books the user can bet at, so parlayapi_verdict scopes its\n best-price and shop recommendations to them automatically (no need to pass\n region/books every call).\n\n Call this once when a user tells you where they bet (\"I'm in the US on\n DraftKings and FanDuel\"). Pass region OR an exact books list.\n\n Args:\n region: us | eu | uk | au | ca.\n books: exact CSV of book keys, e.g. \"draftkings,fanduel,novig\". Overrides region.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_set_bettable_booksArguments",
"properties": {
"books": {
"type": "string",
"title": "Books",
"default": ""
},
"region": {
"type": "string",
"title": "Region",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_set_bettable_booksDictOutput",
"additionalProperties": true
}
}Grade a multi-leg parlay: should you bet it, and at which book? Give 2 to 12 legs (each shaped like a parlayapi_verdict bet) and get the combined no-vig fair price, the single best BOOK to place the whole slip at (a real parlay is one slip, not best-of-each), the parlay's EV, the weakest leg, same-game correlation warnings, and (with stake) the payout. Best-price is scoped to books the user can bet at (set once via parlayapi_set_bettable_books, or pass region/books here). Args: legs: list of leg objects, e.g. [{"sport": "baseball_mlb", "home": "Detroit Tigers", "away": "Kansas City Royals", "market": "h2h", "side": "Detroit Tigers"}, {"sport": "baseball_mlb", "team": "Detroit Tigers", "market": "totals", "side": "over", "line": 8.5}] Each leg: sport, market (h2h/spreads/totals or a player-prop key), side (team, or over/under), home+away or team, player (for props), line. region: us (default) | eu | uk | au | ca. books: exact CSV of books you can bet at (overrides region). stake: optional stake amount, to compute the payout if it hits. book: optional, also report the parlay price at this specific book.
| Parameter | Type | Description |
|---|---|---|
| book | string | |
| legs * | array | |
| books | string | |
| kelly | number | |
| stake | any | |
| region | string | |
| bankroll | any |
What should I bet right now? Ranked +EV plays for a sport. The discovery counterpart to parlayapi_verdict: scans the whole board, grades every candidate with the same no-vig engine, keeps only bets that are +EV at a book the user can bet at, and ranks them by edge. Also returns edge_alerts (books showing a price far off the market). Player props only, priced by several books, prediction markets and game moneylines excluded (for a game line, use parlayapi_verdict). Scoped to the user's books. Args: sport_key: e.g. "baseball_mlb". region: us (default) | eu | uk | au | ca. books: exact CSV of books you can bet at (overrides region). limit: max plays to return (default 20). min_edge: minimum edge %% vs the no-vig fair line (default 2.0).
| Parameter | Type | Description |
|---|---|---|
| books | string | |
| limit | integer | |
| region | string | |
| min_edge | number | |
| sport_key * | string |
{
"name": "parlayapi_best_bets",
"description": "What should I bet right now? Ranked +EV plays for a sport.\n\n The discovery counterpart to parlayapi_verdict: scans the whole board,\n grades every candidate with the same no-vig engine, keeps only bets that\n are +EV at a book the user can bet at, and ranks them by edge. Also returns\n edge_alerts (books showing a price far off the market). Player props only,\n priced by several books, prediction markets and game moneylines excluded\n (for a game line, use parlayapi_verdict). Scoped to the user's books.\n\n Args:\n sport_key: e.g. \"baseball_mlb\".\n region: us (default) | eu | uk | au | ca.\n books: exact CSV of books you can bet at (overrides region).\n limit: max plays to return (default 20).\n min_edge: minimum edge %% vs the no-vig fair line (default 2.0).\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_best_betsArguments",
"required": [
"sport_key"
],
"properties": {
"books": {
"type": "string",
"title": "Books",
"default": ""
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"region": {
"type": "string",
"title": "Region",
"default": ""
},
"min_edge": {
"type": "number",
"title": "Min Edge",
"default": 2
},
"sport_key": {
"type": "string",
"title": "Sport Key"
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_best_betsDictOutput",
"additionalProperties": true
}
}Get info about the API key currently in use: tier, credits remaining, billing period.
No parameters.
{
"name": "parlayapi_account_info",
"description": "Get info about the API key currently in use: tier, credits\n remaining, billing period.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_account_infoArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_account_infoDictOutput",
"additionalProperties": true
}
}Find cross-book arbitrage candidates from current quoted prices. Scans every event for quoted prices whose combined implied probability is under 100%. Results are candidates, not guaranteed executable profit: prices can move or be unavailable, and limits, latency, commissions, voids, settlement rules, or stake constraints can change the outcome. Soccer and other 3-way (home/draw/away) markets are supported, including candidates anchored on the draw. Args: sport_key: e.g. "baseball_mlb", "soccer_epl". min_profit: Minimum profit % to include (e.g. 1.5 for 1.5%). Default 0. exclude_exchanges: Drop arbs anchored on an exchange (novig/prophetx), whose asks can be no-volume. Default False. markets: Comma-separated market_keys to limit the scan (optional), e.g. "h2h,spreads,totals".
| Parameter | Type | Description |
|---|---|---|
| markets | string | |
| sport_key * | string | |
| min_profit | number | |
| exclude_exchanges | boolean |
{
"name": "parlayapi_find_arbitrage",
"description": "Find cross-book arbitrage candidates from current quoted prices.\n\n Scans every event for quoted prices whose combined implied probability\n is under 100%. Results are candidates, not guaranteed executable profit:\n prices can move or be unavailable, and limits, latency, commissions,\n voids, settlement rules, or stake constraints can change the outcome.\n Soccer and other 3-way (home/draw/away) markets are supported, including\n candidates anchored on the draw.\n\n Args:\n sport_key: e.g. \"baseball_mlb\", \"soccer_epl\".\n min_profit: Minimum profit % to include (e.g. 1.5 for 1.5%). Default 0.\n exclude_exchanges: Drop arbs anchored on an exchange (novig/prophetx),\n whose asks can be no-volume. Default False.\n markets: Comma-separated market_keys to limit the scan (optional),\n e.g. \"h2h,spreads,totals\".\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_find_arbitrageArguments",
"required": [
"sport_key"
],
"properties": {
"markets": {
"type": "string",
"title": "Markets",
"default": ""
},
"sport_key": {
"type": "string",
"title": "Sport Key"
},
"min_profit": {
"type": "number",
"title": "Min Profit",
"default": 0
},
"exclude_exchanges": {
"type": "boolean",
"title": "Exclude Exchanges",
"default": false
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_find_arbitrageDictOutput",
"additionalProperties": true
}
}Find positive-EV bets vs a sharp book's no-vig fair line. Compares every soft book's price against the no-vig fair probability derived from a sharp book (default Pinnacle); rows where a soft book offers better odds than the sharp fair price are +EV. Three-way soccer markets use a dedicated no-vig pass over home/draw/away, so +EV on the draw surfaces too. Args: sport_key: e.g. "baseball_mlb", "soccer_epl". sharp_book: Sharp baseline book. Default "pinnacle". min_edge: Minimum edge % to include (e.g. 3 for 3%). Default 2. markets: Comma-separated market_keys (optional).
| Parameter | Type | Description |
|---|---|---|
| markets | string | |
| min_edge | number | |
| sport_key * | string | |
| sharp_book | string |
{
"name": "parlayapi_find_ev",
"description": "Find positive-EV bets vs a sharp book's no-vig fair line.\n\n Compares every soft book's price against the no-vig fair probability\n derived from a sharp book (default Pinnacle); rows where a soft book\n offers better odds than the sharp fair price are +EV. Three-way soccer\n markets use a dedicated no-vig pass over home/draw/away, so +EV on the\n draw surfaces too.\n\n Args:\n sport_key: e.g. \"baseball_mlb\", \"soccer_epl\".\n sharp_book: Sharp baseline book. Default \"pinnacle\".\n min_edge: Minimum edge % to include (e.g. 3 for 3%). Default 2.\n markets: Comma-separated market_keys (optional).\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_find_evArguments",
"required": [
"sport_key"
],
"properties": {
"markets": {
"type": "string",
"title": "Markets",
"default": ""
},
"min_edge": {
"type": "number",
"title": "Min Edge",
"default": 2
},
"sport_key": {
"type": "string",
"title": "Sport Key"
},
"sharp_book": {
"type": "string",
"title": "Sharp Book",
"default": "pinnacle"
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_find_evDictOutput",
"additionalProperties": true
}
}Get consensus (average) odds across all bookmakers per market. Returns average, best, and worst price per (event, market, player, line), a sharp baseline for line-shopping. Soccer and other 3-way markets return separate home, draw, and away consensus rows. Args: sport_key: e.g. "baseball_mlb", "soccer_epl". markets: Comma-separated market_keys (optional), e.g. "moneyline,totals".
| Parameter | Type | Description |
|---|---|---|
| markets | string | |
| sport_key * | string |
{
"name": "parlayapi_consensus",
"description": "Get consensus (average) odds across all bookmakers per market.\n\n Returns average, best, and worst price per (event, market, player,\n line), a sharp baseline for line-shopping. Soccer and other 3-way\n markets return separate home, draw, and away consensus rows.\n\n Args:\n sport_key: e.g. \"baseball_mlb\", \"soccer_epl\".\n markets: Comma-separated market_keys (optional), e.g. \"moneyline,totals\".\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_consensusArguments",
"required": [
"sport_key"
],
"properties": {
"markets": {
"type": "string",
"title": "Markets",
"default": ""
},
"sport_key": {
"type": "string",
"title": "Sport Key"
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_consensusDictOutput",
"additionalProperties": true
}
}Find cross-book middle opportunities. A middle takes the Over at a low line on one book and the Under at a higher line on another, so a window of whole numbers cashes BOTH bets (e.g. Over 7.5 at one book, Under 9.5 at another means 8 or 9 wins both). Scans game totals, spreads, AND player-total props (points, rebounds, strikeouts, ...). Each result carries the window, the numbers that hit, and per-$100 economics: profit_if_hit and net_if_above/below_window. Args: sport_key: e.g. "baseball_mlb", "basketball_nba". min_gap: Minimum window width in points/runs/goals. Default 1.0. markets: Comma-separated market_keys to limit the scan (optional), e.g. "totals" or "player_points". include_props: Include player-total props alongside game lines. Default True.
| Parameter | Type | Description |
|---|---|---|
| markets | string | |
| min_gap | number | |
| sport_key * | string | |
| include_props | boolean |
{
"name": "parlayapi_find_middles",
"description": "Find cross-book middle opportunities.\n\n A middle takes the Over at a low line on one book and the Under at a\n higher line on another, so a window of whole numbers cashes BOTH bets\n (e.g. Over 7.5 at one book, Under 9.5 at another means 8 or 9 wins both).\n Scans game totals, spreads, AND player-total props (points, rebounds,\n strikeouts, ...). Each result carries the window, the numbers that hit,\n and per-$100 economics: profit_if_hit and net_if_above/below_window.\n\n Args:\n sport_key: e.g. \"baseball_mlb\", \"basketball_nba\".\n min_gap: Minimum window width in points/runs/goals. Default 1.0.\n markets: Comma-separated market_keys to limit the scan (optional),\n e.g. \"totals\" or \"player_points\".\n include_props: Include player-total props alongside game lines. Default True.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_find_middlesArguments",
"required": [
"sport_key"
],
"properties": {
"markets": {
"type": "string",
"title": "Markets",
"default": ""
},
"min_gap": {
"type": "number",
"title": "Min Gap",
"default": 1
},
"sport_key": {
"type": "string",
"title": "Sport Key"
},
"include_props": {
"type": "boolean",
"title": "Include Props",
"default": true
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_find_middlesDictOutput",
"additionalProperties": true
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| line | any |
| side * | string |
| team | string |
| books | string |
| kelly | number |
| price | string |
| sport * | string |
| market | string |
| player | string |
| region | string |
| bankroll | any |
{
"name": "parlayapi_verdict",
"description": "Should I bet this? One-call verdict for a specific bet.\n\n Returns the no-vig fair price for the exact bet, the best available price\n and which book has it, how the user's price (if given) grades as EV, a\n line-shopping nudge, and a plain-English call: BET / LEAN / FAIR / PASS\n (or NO_DATA). Use this when a user asks whether a specific bet is worth\n making, or whether they're getting a good number, instead of stitching\n /ev + /consensus + /best-line yourself.\n\n The best-price / shop recommendation is scoped to books the user can bet\n at (default US, so a US bettor is never told to use a euro book). Set it\n once with parlayapi_set_bettable_books and it is remembered per key, or\n pass region / books here per call.\n\n Args:\n sport: sport_key, e.g. \"baseball_mlb\".\n side: the team you'd bet (h2h / spreads), or \"over\" / \"under\" (totals / props).\n market: h2h | spreads | totals | a player-prop key (player_hits, player_points, ...).\n home, away: the two teams, to identify the game. Or pass `team` with one name.\n team: one team name to find the game (alternative to home + away).\n player: player name (required for player-prop markets).\n line: the number for spreads, totals, or props.\n book: the book you'd bet at (grades that book's current price).\n price: the price you're offered (American like -110, or decimal like 1.91).\n Overrides `book`, use it to grade a specific number in hand.\n region: where you can bet: us (default) | eu | uk | au | ca.\n books: exact CSV of books you can bet at (overrides region; use for\n state-level geo-blocks, e.g. \"draftkings,fanduel,novig\").\n bankroll: the user's bankroll; when the bet is +EV, returns a suggested\n Kelly stake amount (\"bet it, ~$X\").\n kelly: Kelly fraction (default 0.5 = half-Kelly, the bankroll-safe standard).\n\n The response also carries an `edge_alert` when a book shows a price far\n better than the market (a possible soft error worth grabbing, or a stale\n line to verify) that the normal best-price guard would otherwise hide.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_verdictArguments",
"required": [
"sport",
"side"
],
"properties": {
"away": {
"type": "string",
"title": "Away",
"default": ""
},
"book": {
"type": "string",
"title": "Book",
"default": ""
},
"home": {
"type": "string",
"title": "Home",
"default": ""
},
"line": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Line",
"default": null
},
"side": {
"type": "string",
"title": "Side"
},
"team": {
"type": "string",
"title": "Team",
"default": ""
},
"books": {
"type": "string",
"title": "Books",
"default": ""
},
"kelly": {
"type": "number",
"title": "Kelly",
"default": 0.5
},
"price": {
"type": "string",
"title": "Price",
"default": ""
},
"sport": {
"type": "string",
"title": "Sport"
},
"market": {
"type": "string",
"title": "Market",
"default": "h2h"
},
"player": {
"type": "string",
"title": "Player",
"default": ""
},
"region": {
"type": "string",
"title": "Region",
"default": ""
},
"bankroll": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Bankroll",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_verdictDictOutput",
"additionalProperties": true
}
}{
"name": "parlayapi_parlay_verdict",
"description": "Grade a multi-leg parlay: should you bet it, and at which book?\n\n Give 2 to 12 legs (each shaped like a parlayapi_verdict bet) and get the\n combined no-vig fair price, the single best BOOK to place the whole slip at\n (a real parlay is one slip, not best-of-each), the parlay's EV, the weakest\n leg, same-game correlation warnings, and (with stake) the payout. Best-price\n is scoped to books the user can bet at (set once via\n parlayapi_set_bettable_books, or pass region/books here).\n\n Args:\n legs: list of leg objects, e.g.\n [{\"sport\": \"baseball_mlb\", \"home\": \"Detroit Tigers\",\n \"away\": \"Kansas City Royals\", \"market\": \"h2h\", \"side\": \"Detroit Tigers\"},\n {\"sport\": \"baseball_mlb\", \"team\": \"Detroit Tigers\",\n \"market\": \"totals\", \"side\": \"over\", \"line\": 8.5}]\n Each leg: sport, market (h2h/spreads/totals or a player-prop key),\n side (team, or over/under), home+away or team, player (for props), line.\n region: us (default) | eu | uk | au | ca.\n books: exact CSV of books you can bet at (overrides region).\n stake: optional stake amount, to compute the payout if it hits.\n book: optional, also report the parlay price at this specific book.\n ",
"inputSchema": {
"type": "object",
"title": "parlayapi_parlay_verdictArguments",
"required": [
"legs"
],
"properties": {
"book": {
"type": "string",
"title": "Book",
"default": ""
},
"legs": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"title": "Legs"
},
"books": {
"type": "string",
"title": "Books",
"default": ""
},
"kelly": {
"type": "number",
"title": "Kelly",
"default": 0.5
},
"stake": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Stake",
"default": null
},
"region": {
"type": "string",
"title": "Region",
"default": ""
},
"bankroll": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Bankroll",
"default": null
}
}
},
"outputSchema": {
"type": "object",
"title": "parlayapi_parlay_verdictDictOutput",
"additionalProperties": true
}
}