Flash Props MCP Server (io.github.iFan6oy/flash-props-api)

Flash Props provides player-prop analysis, projections, evidence, and line movement through the Model Context Protocol (MCP) over REST/MCP. It combines posted lines with self-describing market metadata, and delivers Flash projections when a registered model exists, along with confidence, context, and recent-form evidence across 14 sports including esports.

🛠️ Key Features

Player-prop analysis and projections
Evidence and confidence
Context and line movement
Market metadata combined with posted lines
Coverage across 14 sports, including esports

🚀 Use Cases

Retrieving sports or esports player prop data via MCP client calls
Using posted lines plus evidence for prop analysis
Consuming line movement data and projection outputs across multiple sports

⚡ Developer Benefits

No server installation; use a remote hosted MCP endpoint
Authenticate with a Flash Props API key
Agent-native MCP integration over REST/MCP

⚠️ Limitations

Hosted service requires an API key and remote endpoint access
Flash projections require that a registered model exists for the projection

Flash Props API + MCP

Flash Props API is a player-props API and MCP server by Flash AI Solutions for posted lines, Flash projections, evidence, context, and line movement across sports and esports.

This repository is the public connector and metadata surface for the hosted Flash Props API and MCP service. There is no proprietary Flash Props backend server to install from this repository. Point your client at the hosted endpoint and authenticate with a Flash Props API key for board data.

Canonical Flash Props links

Website: https://api.flashodds.live/
Documentation: https://api.flashodds.live/docs
OpenAPI: https://api.flashodds.live/openapi.json
Public contract: https://api.flashodds.live/contract.json
MCP endpoint: https://api.flashodds.live/mcp
Free API key: https://api.flashodds.live/billing/free
Publisher: https://www.flashaisolutions.org

Connect

Streamable HTTP endpoint:

code

https://api.flashodds.live/mcp

Send your API key in the Authorization header:

code

Authorization: Bearer <your_api_key>

Anonymous access works for capability discovery (list_sports, get_market_metadata) so a client can inspect current coverage on first run. Retrieving board data requires at least a free key. Get one at https://api.flashodds.live/billing/free.

Claude Desktop

Add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "flash-props": {
      "type": "streamable-http",
      "url": "https://api.flashodds.live/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Tools

The access ladder below is generated from the hosted contract. Do not edit it by hand.

Tool	Access
`list_sports`	Anonymous capability discovery
`get_market_metadata`	Anonymous capability discovery
`list_games`	Anonymous preview (first 5); Free+ for the full slate
`get_game_props`	Free+
`scan_props`	Anonymous preview (first 5 rows); Free+; rows capped per tier (Free 15 rows, Builder 100, Pro 3,000, Enterprise 5,000)
`find_game`	Free+
`find_player_props`	Free+
`get_player_context`	Free/Builder basic; Pro full
`get_prop_evidence`	Free teaser; Builder basic; Pro full
`get_prop_history`	Builder limited (latest 25 points); Pro full
`scan_movers`	Builder limited (top 25 movers); Pro full
`get_leaders`	Free top 3; Builder top 10; Pro top 100

What each tool returns:

list_sports: every sport with live status, data freshness, and projection/context capability
get_market_metadata: market labels, families, scope, and whether a market is modeled
list_games: games with props for a sport
get_game_props: all player props for one game
scan_props: market-wide prop scan across the slate
find_game: resolve team names to an event id
find_player_props: every active prop for one player
get_player_context: season baselines, recent form, and deeper context
get_prop_evidence: book line, Flash line, gap, form, confidence, splits, movement
get_prop_history: chronological line and odds history for a prop
scan_movers: biggest line movers in a window
get_leaders: ranked boards for gap, form, and sample strength

REST and MCP share the same entitlement shaping, so a key sees the same product tier regardless of transport.

Provider-driven coverage

Do not hard-code a list of sports with Flash projections. Coverage is resolved from the server's registered model providers and can vary by sport + market.

Use list_sports (or GET /api/v1/sports) to inspect projectionCapability, effectiveProjection, and contextCapability, then use get_market_metadata to determine whether a specific market is modeled. A partially modeled sport can legitimately expose Flash projections for one stat while keeping another stat posted-lines-only.

Missing analysis is reported explicitly. Flash Props does not fabricate a projection to fill an unsupported market.

Reading projections and board snapshots

Check basis on every projection. current_season is built from this season. prior_season is a prior-season baseline and must never be presented as current form; basisNote and seasonId explain which season it came from.
Use snapshotId to tell whether numbers describe the same board. Equal snapshotId values on sports, games, and props responses mean counts and rows came from the same logical board. A mixed consistency value means the response is partial, so do not compare its counts against rows from another snapshot.

Tiers

Generated from the hosted contract. Do not edit by hand.

Free: $0, 300 requests/day, 10 requests/minute, 15-row scans, evidence teaser, context basic, history none, movement none, top 3 leaders
Builder (internal id starter): $19/mo, 25,000 requests/day, 120 requests/minute, 100-row scans, evidence basic, context basic, history limited, movement limited, top 10 leaders
Pro: $49/mo, 150,000 requests/day, 600 requests/minute, 3,000-row scans, evidence full, context full, history full, movement full, top 100 leaders
Enterprise: custom limits

See current pricing and the REST reference at https://api.flashodds.live/.

Contract

Tier limits, entitlements, and the MCP tool ladder in this README are generated, not written by hand. The hosted API publishes a keyless, machine-readable contract, and this repository vendors a copy at contract/flash-props-contract.json.

Machine sources, in order of authority:

GET https://api.flashodds.live/contract.json: tiers, quotas, entitlements, MCP tools and access, sports vocabulary, projection and snapshot rules. Static per API release.
GET https://api.flashodds.live/api/v1/sports (requires a Free key) or the anonymous MCP list_sports tool: runtime state. Which sports are modeled, live, or fresh right now lives here, never in the contract or this README.

Maintainers:

code

node scripts/contract.mjs sync          # regenerate README blocks and server.json version
node scripts/contract.mjs check         # offline drift gate (runs on every push and PR)
node scripts/contract.mjs check --live  # also compare the vendored copy to the hosted contract
node scripts/contract.mjs links         # check every https link in this README

CI fails when the generated blocks are stale, when prose quotes a quota or price the contract does not contain, when a retired tier name appears, when a frozen list of modeled sports appears, when server.json disagrees with the contract version or MCP endpoint, or when the README and contract disagree about which tools exist. A daily scheduled job also compares the vendored contract against the hosted one, so drift is caught even when this repository does not change.

Disclaimer

Data is informational only. Flash Props is not a sportsbook and is not affiliated with any league, team, player, sportsbook, or DFS operator.

eventId	string	required	Event id from list_games or find_game. Prefixed ud- or bv-, e.g. "bv-26839935" or "ud-119284".
sport	string	optional	Sport id. Must match the sport the event belongs to. Omit to use the current in-season sport.
stats	string	optional	Comma-separated list of stat keys to return, e.g. "points,rebounds,assists" for basketball or "strikeouts,hits_allowed" for MLB. Omit to return all available markets.

sport	string	optional	Sport id. Omit to use the current in-season sport.
stat	string	optional	Filter to exactly one stat market. Omit to return all stat types.
limit	integer	optional	Maximum number of rows to return. Capped at your tier limit (free=25, starter=100, pro+=500). Omit to return up to your tier maximum.

home	string	required	Home team name or city, matched as a case-insensitive substring of the full team name.
away	string	required	Away team name or city, matched the same way.
sport	string	optional	Sport id. Omit to default to the current in-season sport.

name	string	required	Player name or gamertag, e.g. "Judge" or "Shotzzy"
sport	string	optional	Sport id. Defaults to the in-season sport.

name	string	required	Player name or gamertag. Exact match is preferred; no invented identity mapping.
sport	string	optional	Sport id. Use list_sports to discover contextCapability. Defaults to cod for backward compatibility.

io.github.iFan6oy/flash-props-api

Flash Props MCP Server (io.github.iFan6oy/flash-props-api)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_sports

get_market_metadata

list_games

get_game_props

scan_props

find_game

find_player_props

get_player_context

get_prop_evidence

get_prop_history

scan_movers

get_leaders

Flash Props API + MCP

Canonical Flash Props links

Connect

Claude Desktop

Tools

Provider-driven coverage

Reading projections and board snapshots

Tiers

Contract

Disclaimer

Links

Install

Remote endpoint

Related servers

player	string	required	Player name or gamertag (exact normalized match preferred, contains-match fallback).
stat	string	required	Stat key. Call get_market_metadata for the vocabulary.
sport	string	optional	Sport id. Use list_sports/get_market_metadata to discover whether the sport + market is modeled. Defaults to cod.
event	string	optional	Optional event id to disambiguate multi-game slates.

metric	string	optional	gap (default), form, or sample.
sport	string	optional	Sport id with a registered Flash pack. Defaults to cod.
stat	string	optional	Restrict the gap board to one market.
limit	integer	optional	Max rows before tier shaping (default 20).