Fonbet

MCP server for reading Fonbet sports events and odds.

Important: Fonbet does not provide a stable public API contract for this use case. Use this server only where it complies with local law, the bookmaker rules, and request limits. Betting forecasts are not financial guarantees: the server helps analyze odds, probability, and value, but it cannot promise profit.

Local install

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .
Copy-Item .env.example .env

Local ChatGPT run

$env:MCP_TRANSPORT="streamable-http"
$env:MCP_HOST="127.0.0.1"
$env:MCP_PORT="8000"
python -m fonbet_mcp.server

Local endpoint:

http://127.0.0.1:8000/mcp

Render Free deploy

This repo includes render.yaml.

1. Push this folder to a GitHub repository.
2. Open Render: https://render.com
3. New + -> Blueprint.
4. Connect the GitHub repository.
5. Render will read render.yaml and create fonbet-odds-mcp.
6. After deploy, use this ChatGPT connector URL:

https://YOUR-RENDER-SERVICE.onrender.com/mcp

If you create a Web Service manually instead of Blueprint:

• Build command: pip install -e .
• Start command: python -m fonbet_mcp.server
• Environment variables:
  • MCP_TRANSPORT=streamable-http
  • MCP_HOST=0.0.0.0
  • MCP_PATH=/mcp
  • MCP_MESSAGE_PATH=/messages/
  • MCP_DNS_REBINDING_PROTECTION=false
  • FONBET_BASE_URL=https://line-lb51.bk6bba-resources.com
  • FONBET_CURRENT_LINE_PATH=/events/listBase
  • FONBET_EVENT_VIEW_PATH=/events/event
  • FONBET_SCOPE_MARKET=1600
  • FONBET_TIMEOUT=20

MCP tools

• fonbet_search_events - search events by team, league, or sport.
• fonbet_event_odds - compatibility tool: first large page of event odds by event_id.
• get_event_odds - paginated full event markets; use offset, limit, query, and next_offset.
• get_special_bets - search current line for special/player/stat-style markets.
• get_same_game_parlay - inspect one event for same-game parlay ideas.
• get_cross_match_specials - inspect special-style markets across multiple events.
• fonbet_value_check - simple value-bet check from your estimated probability.

Current Fonbet endpoints

• GET /events/listBase?scopeMarket=1600&lang=ru
• GET /events/event?eventId=...&scopeMarket=1600&lang=ru

Odds are read from customFactors[].factors[]; f is the factor id and v is the decimal odds value.