
Footballbin Mcp Server
io.github.billychl1Published by GitHub account billychl1v1.0.4Updated Oct 24, 2026
AI match predictions for Premier League & Champions League - scores, goals, corners
Overview
Gives an assistant AI match predictions for Premier League and Champions League fixtures: half-time and full-time scores, next goal scorer and corner counts.
- What you can do
- Retrieve match predictions for a league and matchweek, optionally filtered by home or away team
- Get predicted half-time and full-time scores, next goal scorer and corner counts per match
- See key player insights with reasoning for each fixture
- Use team aliases such as spurs or united when filtering
- When to use it
- Useful when you want an assistant to look up or discuss upcoming Premier League or Champions League predictions, previews or match-by-match outlooks without opening the companion app.
- Requirements
- Either the hosted HTTPS endpoint (no install) or the npm package footballbin-mcp-server run locally with Node.js 18+ (README also states Node.js 20+). No accounts, API keys or environment variables are declared.
Installation
In SourceWeft
- Open Footballbin Mcp Server in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
FootballBin MCP Server
[npm version] [MCP Registry] [License: MIT]
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)
Option 2: npx (No Install)
Option 3: Remote Endpoint
No installation required - use the hosted endpoint directly:
Quick 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
Step 2: Find your Node.js path (must be v18+)
Step 3: Add to claude_desktop_config.json:
Example configs:
macOS with nvm:
macOS with Homebrew:
Windows:
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:
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
Direct API Usage
List Tools
Get Predictions
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
Source: README.md at commit 447de98
Tools
0Version history
1- v1.0.4LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts