ParlayAPI
PYPI · PARLAYAPI-MCP · 2 COMPONENTS · SCANNED SEP 20
Sports odds, player props and source coverage for AI assistants. Connect with your own API key.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security50
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
- 1 of 32 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 12 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability79
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 3420 tokens (~148/item across 23 items; 22 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management87
- Stability observed for 26 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 22 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 23 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the ParlayAPI MCP server?
ParlayAPI runs locally as a PyPI package, launched with uvx parlayapi-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · parlayapi-mcp
claude mcp add jacobiusmakes-parlayapi -- uvx parlayapi-mcp
{
"mcpServers": {
"jacobiusmakes-parlayapi": {
"command": "uvx",
"args": [
"parlayapi-mcp"
]
}
}
} {
"servers": {
"jacobiusmakes-parlayapi": {
"command": "uvx",
"args": [
"parlayapi-mcp"
]
}
}
} codex mcp add jacobiusmakes-parlayapi -- uvx parlayapi-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"jacobiusmakes-parlayapi": {
"type": "local",
"command": [
"uvx",
"parlayapi-mcp"
],
"enabled": true
}
}
} openclaw mcp add jacobiusmakes-parlayapi --command uvx --arg parlayapi-mcp
mcp_servers:
jacobiusmakes-parlayapi:
command: "uvx"
args: ["parlayapi-mcp"] {
"McpServers": {
"jacobiusmakes-parlayapi": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"parlayapi-mcp"
]
}
}
} assistant mcp add jacobiusmakes-parlayapi -t stdio -c uvx -a parlayapi-mcp
{
"mcpServers": {
"jacobiusmakes-parlayapi": {
"command": "uvx",
"args": [
"parlayapi-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 77 to 80. That category is still filling its 30-day observation window: 23 days of observed history at the previous scan, 24 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- 16 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 70 to 73. That category is still filling its 30-day observation window: 21 days of observed history at the previous scan, 22 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Sept 26 +15
- Malware scan: unverified → pass ▲ security
- 14 Sept 26 −14
- Malware scan: pass → unverified ▼ security
- 12 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 57 to 60. That category is still filling its 30-day observation window: 17 days of observed history at the previous scan, 18 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
- Security disclosure: fail → pass ▲ functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed pypi/parlayapi-mcp@0.3.7
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 32 packages
| Packages resolved | 32 |
|---|---|
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
parlayapi_account_info ~30
Get info about the API key currently in use: tier, credits remaining, billing period.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_best_bets ~244
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).
| Name | Type | Req | Description |
|---|---|---|---|
| books | string | – | – |
| limit | integer | – | – |
| min_edge | number | – | – |
| region | string | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_best_line ~108
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).
| Name | Type | Req | Description |
|---|---|---|---|
| bookmakers | string | – | – |
| market | string | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_book_coverage ~68
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.
| Name | Type | Req | Description |
|---|---|---|---|
| include_warn | boolean | – | – |
| window_minutes | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_checkout_link ~50
Generate a Stripe Checkout URL the user can click to upgrade. Use parlayapi_get_pricing for current tiers and prices.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | – | |
| tier | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_consensus ~124
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".
| Name | Type | Req | Description |
|---|---|---|---|
| markets | string | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_find_arbitrage ~199
Request calculated cross-book price combinations. Calculations depend on the returned source quotes and requested filters. Quotes, liquidity and execution can change; profit is not guaranteed. Availability depends on the requested sport, event, market and source. 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".
| Name | Type | Req | Description |
|---|---|---|---|
| exclude_exchanges | boolean | – | – |
| markets | string | – | – |
| min_profit | number | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_find_ev ~199
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).
| Name | Type | Req | Description |
|---|---|---|---|
| markets | string | – | – |
| min_edge | number | – | – |
| sharp_book | string | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_find_middles ~246
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.
| Name | Type | Req | Description |
|---|---|---|---|
| include_props | boolean | – | – |
| markets | string | – | – |
| min_gap | number | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_get_odds ~168
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
| Name | Type | Req | Description |
|---|---|---|---|
| bookmakers | string | – | – |
| markets | string | – | – |
| odds_format | string | – | – |
| regions | string | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_get_pricing ~45
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.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_get_props ~167
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).
| Name | Type | Req | Description |
|---|---|---|---|
| bookmakers | string | – | – |
| include_futures | boolean | – | – |
| markets | string | – | – |
| player | string | – | – |
| sport_key | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_list_sports ~70
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_*.
| Name | Type | Req | Description |
|---|---|---|---|
| active_only | boolean | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
parlayapi_live_command_center ~81
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| sport_key | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_live_search ~70
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| q | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_live_sports ~49
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
parlayapi_magic_link ~56
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.
| Name | Type | Req | Description |
|---|---|---|---|
| string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_parlay_verdict ~389
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.
| Name | Type | Req | Description |
|---|---|---|---|
| bankroll | – | – | – |
| book | string | – | – |
| books | string | – | – |
| kelly | number | – | – |
| legs | array | yes | – |
| region | string | – | – |
| stake | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_set_bettable_books ~139
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.
| Name | Type | Req | Description |
|---|---|---|---|
| books | string | – | – |
| region | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_signup ~210
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".
| Name | Type | Req | Description |
|---|---|---|---|
| agent_id | string | – | – |
| string | yes | – | |
| intended_use | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_source_quality ~59
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| minutes | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
parlayapi_verdict ~629
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 norma…
| Name | Type | Req | Description |
|---|---|---|---|
| away | string | – | – |
| bankroll | – | – | – |
| book | string | – | – |
| books | string | – | – |
| home | string | – | – |
| kelly | number | – | – |
| line | – | – | – |
| market | string | – | – |
| player | string | – | – |
| price | string | – | – |
| region | string | – | – |
| side | string | yes | – |
| sport | string | yes | – |
| team | string | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
What is the ParlayAPI MCP server?
ParlayAPI is an MCP server listed in the public MCP registry as io.github.JacobiusMakes/parlayapi. Sports odds, player props and source coverage for AI assistants. Connect with your own API key. This page covers its PyPI package (parlayapi-mcp).
Is the ParlayAPI MCP server safe to use?
ParlayAPI scores 67 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the ParlayAPI MCP server expose?
ParlayAPI exposes 22 tools: parlayapi_signup, parlayapi_checkout_link, parlayapi_magic_link, parlayapi_get_pricing, parlayapi_live_sports, and 17 more. Their descriptions and schemas cost roughly 3,400 tokens of context every time the server is loaded.
Is the ParlayAPI MCP server still maintained?
ParlayAPI is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the ParlayAPI MCP server under?
ParlayAPI declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.