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

VerifiedSTDIODesktop onlyLocation & Lifestyle

Overview

AI-generated 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.
Before you install
Predictions are third-party estimates, not guaranteed outcomes; treat them as opinion, not betting advice. Requests go to the provider's hosted service, and responses include a link to the provider's iOS app.

Installation

In SourceWeft

  1. Open Footballbin Mcp Server in the dashboard and add it to a workspace.
  2. 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)

bash
npm install -g footballbin-mcp-server

Option 2: npx (No Install)

bash
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

bash
npm install -g footballbin-mcp-server

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

bash
which node && node --version

Step 3: Add to claude_desktop_config.json:

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

Example configs:

macOS with nvm:

json
{  "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:

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

Windows:

json
{  "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

ParameterTypeRequiredDescription
leaguestringYespremier_league, epl, pl, champions_league, ucl, cl
matchweeknumberNoMatchweek number (defaults to current)
home_teamstringNoFilter by home team (e.g., chelsea, arsenal)
away_teamstringNoFilter by away team (e.g., liverpool, wolves)

Team Aliases

AliasMaps To
united, mufcman_utd
city, mcfcman_city
spurstottenham
villaaston_villa
forestnottm_forest
palacecrystal_palace
gunnersarsenal
redsliverpool
blueschelsea
barcabarcelona
realreal_madrid

Example Response

json
{  "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

bash
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

bash
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

FootballBin App

Get the full experience with the FootballBin iOS app:

[Download on App Store]

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

CodeMeaning
-32700Parse error
-32600Invalid request
-32601Method not found
-32602Invalid params

License

MIT License - see LICENSE file.

Links

Source: README.md at commit 447de98

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  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