iFan6oy/flash-props-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
- Postman setup guide
- Public Postman workspace
- Postman JSON collection
Explore the API with Postman
The Flash Props public Postman workspace contains the collection for graphical exploration and forking. To get your first successful request without an SDK, start with the Postman quickstart, create a free key, then run the **List supported sports with live status + capability** request inside the Start here folder.
If Postman isn't accessible from your browser, download the credential-free collection JSON and use Postman's **Import** action. Our API host maintains that JSON as the reference copy; the marketplace copy may lag after a product release.
Never paste your key into GitHub, a URL, a shared collection variable, or a screenshot. The collection's apiKey variable is intentionally empty; set your key privately in Postman before running authenticated requests.
Try the REST API in two requests (Node 20+)
New to sports data integrations? Run the dependency-free first-request example. It reads the current sport catalog, then fetches the market vocabulary for a sport you choose. This is a read-only example, with no wagers, betting automation, SDK install, or paid plan required.
1. Get a free Flash Props API key.
2. Put the key in your local FLASH_PROPS_API_KEY environment variable. Keep it out of commits and query strings.
3. Run node examples/first-request.mjs for CS2 or node examples/first-request.mjs nfl for NFL.
On macOS/Linux, one shell-safe way to enter the key without saving it to command history is read -rs FLASH_PROPS_API_KEY && export FLASH_PROPS_API_KEY. On PowerShell, use $env:FLASH_PROPS_API_KEY = Read-Host "Flash Props API key". Clear the variable after using it.
The script checks for 401, 403 and 429 without leaking your key or silently retrying into a quota wall. It uses GET /api/v1/sports as the source of truth for current coverage; its chosen sport may have no live board right now. Tests are included under examples/first-request.test.mjs, using mocked responses and no network.
**Want to connect an AI agent instead?** Use the remote MCP endpoint below with the same key and plan. Prefer the live public contract if a third-party directory's cached feature list is older than the hosted server.
Connect
Streamable HTTP endpoint:
Send your API key in the Authorization header:
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:
Tools
The access ladder below is generated from the hosted contract. Do not edit it by hand.