Footballbin MCP Server

FootballBin MCP Server

A Model Context Protocol (MCP) server that provides AI agents with access to football match predictions for the Premier League and Champions League.

Requirements

• Node.js 18+ (check with node --version)

Installation

Option 1: npm (Recommended)

npm install -g footballbin-mcp-server

Option 2: npx (No Install)

npx footballbin-mcp-server

Option 3: Remote Endpoint

No installation required - use the hosted endpoint directly:

https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp

Quick Start

Claude.ai (Easiest - No Install)

1. Go to Settings > Connectors
2. Click Add custom connector
3. Enter: https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp

Claude Desktop

Requires Node.js 18+

Step 1: Install globally

npm install -g footballbin-mcp-server

Step 2: Find your Node.js path (must be v18+)

which node && node --version

Step 3: Add to claude_desktop_config.json:

{

"mcpServers": { "footballbin": { "command": "/path/to/node", "args": ["/path/to/node_modules/footballbin-mcp-server/dist/index.js"] } } }

Example configs:

macOS with nvm:

{

"mcpServers": { "footballbin": { "command": "/Users/YOU/.nvm/versions/node/v20.x.x/bin/node", "args": ["/Users/YOU/.nvm/versions/node/v20.x.x/lib/node_modules/footballbin-mcp-server/dist/index.js"] } } }

macOS with Homebrew:

{

"mcpServers": { "footballbin": { "command": "/opt/homebrew/bin/node", "args": ["/opt/homebrew/lib/node_modules/footballbin-mcp-server/dist/index.js"] } } }

Windows:

{

"mcpServers": { "footballbin": { "command": "C:\\Program Files\\nodejs\\node.exe", "args": ["C:\\Users\\YOU\\AppData\\Roaming\\npm\\node_modules\\footballbin-mcp-server\\dist\\index.js"] } } }

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Other MCP Clients

Use the remote endpoint:

https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp

Features

• AI Match Predictions:
• Half-time score
• Full-time score
• Next goal scorer
• Corner count predictions

• Supported Leagues:
• Premier League (EPL)
• UEFA Champions League (UCL)

• Key Players: Each match includes key player insights with reasoning

Tool: get_match_predictions

Input Parameters

Team Aliases

Example Response

{

"league": "premier_league", "matchweek": 22, "count": 10, "app_link": "https://apps.apple.com/app/footballbin/id6757111871", "matches": [ { "match_id": "epl_mw22_liv_bur", "home_team": "Liverpool", "away_team": "Burnley", "kickoff_time": "2026-01-17T15:00:00Z", "status": "scheduled", "predictions": [ { "type": "Half Time Result", "value": "2:0", "confidence": 75 }, { "type": "Full Time Result", "value": "4:0", "confidence": 75 }, { "type": "Next Goal", "value": "Home,Wirtz", "confidence": 75 }, { "type": "Corner Count", "value": "9:3", "confidence": 75 } ], "key_players": [ { "player_name": "Florian Wirtz", "reason": "12 goals, 14 assists. Liverpool's creative hub." } ] } ] }

Direct API Usage

List Tools

curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \

-H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Get Predictions

curl -X POST https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp \

-H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "get_match_predictions", "arguments": {"league": "premier_league"} }, "id": 1 }'

Registry Links

• npm: https://www.npmjs.com/package/footballbin-mcp-server
• Official MCP Registry: https://registry.modelcontextprotocol.io
• GitHub: https://github.com/billychl1/footballbin-mcp-server

FootballBin App

Get the full experience with the FootballBin iOS app:

Features:

• Live match tracking
• AI player valuations
• Detailed match predictions
• Player news and discussions

Technical Details

• Protocol: JSON-RPC 2.0 / MCP
• Transport: stdio (npm) or HTTPS (remote)
• Runtime: Node.js 20+

Error Codes

License

MIT License - see LICENSE file.

Links

• FootballBin App
• Model Context Protocol