bet-mcp

# bet-mcp MCP server (FastMCP + TypeScript) that focuses on Serie A pre-match analysis: - `fixtures_list` – next fixtures in a configurable window - `match_snapshot` – last 5 results, standings, GF/GA averages - `odds_prematch` – normalized odds for 1X2 / OU 2.5 / BTTS across bookmakers - `fair_compute` – Poisson-lite probabilities + fair odds - `value_detect` – top value picks by comparing best odds vs fair model ## Getting started 1. Install dependencies (Node 20+ recommended): ```bash npm install ``` 2. Copy `.env.example` to `.env` and provide your keys: ```bash cp .env.example .env # edit the file with FOOTBALL_DATA_TOKEN and ODDS_API_KEY ``` 3. Run locally: ```bash # stdio (Claude Desktop / terminal) npm run dev # or HTTP transport for remote testing MCP_TRANSPORT=http PORT=8080 npm run dev ``` 4. Build for production: ```bash npm run build npm start ``` 5. Deploy on [glama.ai](https://glama.ai): Glama uses the included `glama.yaml`/`glama.json` files to run `npm install && npm run build`, then starts the server with `MCP_TRANSPORT=http` on port `8080`. Configure `FOOTBALL_DATA_TOKEN` and `ODDS_API_KEY` (others optional) in the Glama dashboard so inspections and tool detection can succeed. ## Implementation notes - **Stack** – FastMCP + Axios + Zod, TypeScript strict mode. - **API clients** – Football-Data.org for fixtures/stats; The Odds API for consolidated odds. - **Modeling** – Poisson using GF/GA averages + configurable home advantage, derived OU/BTTS probs. - **Caching** – In-memory TTL cache to reduce API calls (configurable via `CACHE_TTL_SECONDS`). - **Value picks** – Filters by `edge >= 5%` and `odds >= 1.50`, returns rationale referencing λ/form. ## Environment variables | key | description | | --- | --- | | `FOOTBALL_DATA_TOKEN` | Football-Data.org API token | | `FOOTBALL_DATA_COMPETITION` | Defaults to `SA` | | `FOOTBALL_DATA_SEASON` | Defaults to current year | | `ODDS_API_KEY` | The Odds API key | | `ODDS_API_REGION` | Regions filter (default `eu`) | | `ODDS_API_MARKETS` | Markets request list (default `h2h,totals,btts`) | | `ODDS_API_SPORT` | Sport key (`soccer_italy_serie_a`) | | `HOME_ADVANTAGE_FACTOR` | Poisson λ multiplier for home team | | `CACHE_TTL_SECONDS` | Cache TTL (default 120) | | `MCP_TRANSPORT` | `stdio` (default) or `http` | | `PORT` | HTTP port when `MCP_TRANSPORT=http` | ## Testing Use `npx fastmcp dev src/index.ts` or `npx fastmcp inspect src/index.ts` after installing dependencies to interactively test the tools.