{
  "markdown": "# FootballBin MCP Server\n\n[![npm version](https://img.shields.io/npm/v/footballbin-mcp-server.svg)](https://www.npmjs.com/package/footballbin-mcp-server)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server that provides AI agents with access to football match predictions for the Premier League and Champions League.\n\n## Requirements\n\n- **Node.js 18+** (check with `node --version`)\n\n## Installation\n\n### Option 1: npm (Recommended)\n\n```bash\nnpm install -g footballbin-mcp-server\n```\n\n### Option 2: npx (No Install)\n\n```bash\nnpx footballbin-mcp-server\n```\n\n### Option 3: Remote Endpoint\n\nNo installation required - use the hosted endpoint directly:\n```\nhttps://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp\n```\n\n## Quick Start\n\n### Claude.ai (Easiest - No Install)\n\n1. Go to **Settings > Connectors**\n2. Click **Add custom connector**\n3. Enter: `https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp`\n\n### Claude Desktop\n\n**Requires Node.js 18+**\n\n**Step 1:** Install globally\n```bash\nnpm install -g footballbin-mcp-server\n```\n\n**Step 2:** Find your Node.js path (must be v18+)\n```bash\nwhich node && node --version\n```\n\n**Step 3:** Add to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"footballbin\": {\n      \"command\": \"/path/to/node\",\n      \"args\": [\"/path/to/node_modules/footballbin-mcp-server/dist/index.js\"]\n    }\n  }\n}\n```\n\n**Example configs:**\n\nmacOS with nvm:\n```json\n{\n  \"mcpServers\": {\n    \"footballbin\": {\n      \"command\": \"/Users/YOU/.nvm/versions/node/v20.x.x/bin/node\",\n      \"args\": [\"/Users/YOU/.nvm/versions/node/v20.x.x/lib/node_modules/footballbin-mcp-server/dist/index.js\"]\n    }\n  }\n}\n```\n\nmacOS with Homebrew:\n```json\n{\n  \"mcpServers\": {\n    \"footballbin\": {\n      \"command\": \"/opt/homebrew/bin/node\",\n      \"args\": [\"/opt/homebrew/lib/node_modules/footballbin-mcp-server/dist/index.js\"]\n    }\n  }\n}\n```\n\nWindows:\n```json\n{\n  \"mcpServers\": {\n    \"footballbin\": {\n      \"command\": \"C:\\\\Program Files\\\\nodejs\\\\node.exe\",\n      \"args\": [\"C:\\\\Users\\\\YOU\\\\AppData\\\\Roaming\\\\npm\\\\node_modules\\\\footballbin-mcp-server\\\\dist\\\\index.js\"]\n    }\n  }\n}\n```\n\n**Config file location:**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n### Other MCP Clients\n\nUse the remote endpoint:\n```\nhttps://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp\n```\n\n## Features\n\n- **AI Match Predictions**:\n  - Half-time score\n  - Full-time score\n  - Next goal scorer\n  - Corner count predictions\n\n- **Supported Leagues**:\n  - Premier League (EPL)\n  - UEFA Champions League (UCL)\n\n- **Key Players**: Each match includes key player insights with reasoning\n\n## Tool: get_match_predictions\n\n### Input Parameters\n\n| Parameter | Type | Required | Description |\n|-----------|------|----------|-------------|\n| `league` | string | Yes | `premier_league`, `epl`, `pl`, `champions_league`, `ucl`, `cl` |\n| `matchweek` | number | No | Matchweek number (defaults to current) |\n| `home_team` | string | No | Filter by home team (e.g., `chelsea`, `arsenal`) |\n| `away_team` | string | No | Filter by away team (e.g., `liverpool`, `wolves`) |\n\n### Team Aliases\n\n| Alias | Maps To |\n|-------|---------|\n| `united`, `mufc` | `man_utd` |\n| `city`, `mcfc` | `man_city` |\n| `spurs` | `tottenham` |\n| `villa` | `aston_villa` |\n| `forest` | `nottm_forest` |\n| `palace` | `crystal_palace` |\n| `gunners` | `arsenal` |\n| `reds` | `liverpool` |\n| `blues` | `chelsea` |\n| `barca` | `barcelona` |\n| `real` | `real_madrid` |\n\n### Example Response\n\n```json\n{\n  \"league\": \"premier_league\",\n  \"matchweek\": 22,\n  \"count\": 10,\n  \"app_link\": \"https://apps.apple.com/app/footballbin/id6757111871\",\n  \"matches\": [\n    {\n      \"match_id\": \"epl_mw22_liv_bur\",\n      \"home_team\": \"Liverpool\",\n      \"away_team\": \"Burnley\",\n      \"kickoff_time\": \"2026-01-17T15:00:00Z\",\n      \"status\": \"scheduled\",\n      \"predictions\": [\n        { \"type\": \"Half Time Result\", \"value\": \"2:0\", \"confidence\": 75 },\n        { \"type\": \"Full Time Result\", \"value\": \"4:0\", \"confidence\": 75 },\n        { \"type\": \"Next Goal\", \"value\": \"Home,Wirtz\", \"confidence\": 75 },\n        { \"type\": \"Corner Count\", \"value\": \"9:3\", \"confidence\": 75 }\n      ],\n      \"key_players\": [\n        {\n          \"player_name\": \"Florian Wirtz\",\n          \"reason\": \"12 goals, 14 assists. Liverpool's creative hub.\"\n        }\n      ]\n    }\n  ]\n}\n```\n\n## Direct API Usage\n\n### List Tools\n\n```bash\ncurl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"method\":\"tools/list\",\"id\":1}'\n```\n\n### Get Predictions\n\n```bash\ncurl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"get_match_predictions\",\n      \"arguments\": {\"league\": \"premier_league\"}\n    },\n    \"id\": 1\n  }'\n```\n\n## Registry Links\n\n- **npm**: https://www.npmjs.com/package/footballbin-mcp-server\n- **Official MCP Registry**: https://registry.modelcontextprotocol.io\n- **GitHub**: https://github.com/billychl1/footballbin-mcp-server\n\n## FootballBin App\n\nGet the full experience with the FootballBin iOS app:\n\n[![Download on App Store](https://developer.apple.com/assets/elements/badges/download-on-the-app-store.svg)](https://apps.apple.com/app/footballbin/id6757111871)\n\nFeatures:\n- Live match tracking\n- AI player valuations\n- Detailed match predictions\n- Player news and discussions\n\n## Technical Details\n\n- **Protocol**: JSON-RPC 2.0 / MCP\n- **Transport**: stdio (npm) or HTTPS (remote)\n- **Runtime**: Node.js 20+\n\n### Error Codes\n\n| Code | Meaning |\n|------|---------|\n| -32700 | Parse error |\n| -32600 | Invalid request |\n| -32601 | Method not found |\n| -32602 | Invalid params |\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file.\n\n## Links\n\n- [FootballBin App](https://apps.apple.com/app/footballbin/id6757111871)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n",
  "bytes": 6232,
  "sha": "0ee0d319289460ffb9cd6eadb9d89c4c10d7334646d51b486199efb4b7440cca",
  "repo_slug": "billychl1/footballbin-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_billychl1_footballbin_mcp_serv_959d493a/readme"
}