FootballBin MCP Server
The FootballBin MCP Server provides AI-powered football match predictions for Premier League and Champions League competitions.
Key capabilities:
Get match predictions using the
get_match_predictionstool with detailed forecasts including half-time scores, full-time scores, next goal scorer, corner counts, and confidence levelsFilter predictions by league (EPL/PL or UCL/CL), matchweek number, home team, and/or away team
Access key player insights with reasoning for each predicted match
View match details including kickoff times, match IDs, and match status
Use flexible team aliases (e.g., "united" for Man Utd, "spurs" for Tottenham, "barca" for Barcelona)
Integrate via multiple methods: npm package, npx execution, remote HTTPS endpoint, or Claude.ai connector
Make direct API calls using JSON-RPC 2.0 protocol for integration with AI agents and MCP clients
Provides AI-powered match predictions for Premier League games, including half-time and full-time scores, next goal scorer, corner counts, and key player insights.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FootballBin MCP Server get predictions for the next Manchester United match"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Related MCP server: football-api-mcp
Installation
Option 1: npm (Recommended)
npm install -g footballbin-mcp-serverOption 2: npx (No Install)
npx footballbin-mcp-serverOption 3: Remote Endpoint
No installation required - use the hosted endpoint directly:
https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcpQuick Start
Claude.ai (Easiest - No Install)
Go to Settings > Connectors
Click Add custom connector
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-serverStep 2: Find your Node.js path (must be v18+)
which node && node --versionStep 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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Other MCP Clients
Use the remote endpoint:
https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcpFeatures
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
Parameter | Type | Required | Description |
| string | Yes |
|
| number | No | Matchweek number (defaults to current) |
| string | No | Filter by home team (e.g., |
| string | No | Filter by away team (e.g., |
Team Aliases
Alias | Maps To |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
Official MCP Registry: https://registry.modelcontextprotocol.io
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
Code | Meaning |
-32700 | Parse error |
-32600 | Invalid request |
-32601 | Method not found |
-32602 | Invalid params |
License
MIT License - see LICENSE file.
Links
Available Tools
1 toolget_match_predictionsC
Get AI-powered predictions for Premier League and Champions League matches including half-time score, full-time score, next goal scorer, and corner predictions.
Inputs: league (required), matchweek, home_team, away_team.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against for patterns or conventions.
One tool is too few for a server focused on football match predictions, as it suggests a limited scope that may not cover related operations like historical data, team statistics, or user preferences. This feels thin for the apparent domain.
The server is severely incomplete for football predictions, as it only provides predictions without supporting tools for data retrieval, updates, or other predictive features like odds analysis or match scheduling. This creates significant gaps for agent workflows.
Maintenance
Related MCP Connectors
Football fixtures, standings, and odds intelligence for AI agents.
Grounded sports predictions plus European soccer and tennis arbitrage data for AI agents.
Football analysis: predictions, line-ups, tactics, live state, tables and an AI leaderboard.
Live competitive-game predictions, meta data and decision tools for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides live football match data from Sofascore, including formations, injuries, betting odds, and league positions, enabling natural language queries about matches.1-
- AlicenseAqualityCmaintenanceEnables AI assistants to query live football data, including fixtures, live scores, standings, statistics, betting odds, and full odds movement history for corner and card lines.1115 npmMIT
- AlicenseAqualityBmaintenanceProvides AI agents with real football data from the OpenFoot API, including fixtures, standings, lineups, live events, shot-level xG with pitch coordinates, league tables, and fair odds.1238 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to retrieve soccer match details, live scores, fixtures by date, and win/draw/loss predictions through the Sportmonks Football v3 API.285 npmMIT