Skip to main content
Glama
FootballBin MCP Server

FootballBin MCP Server

by billychl1

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)

Related MCP server: football-api-mcp

Installation

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

Parameter

Type

Required

Description

league

string

Yes

premier_league, epl, pl, champions_league, ucl, cl

matchweek

number

No

Matchweek number (defaults to current)

home_team

string

No

Filter by home team (e.g., chelsea, arsenal)

away_team

string

No

Filter by away team (e.g., liverpool, wolves)

Team Aliases

Alias

Maps To

united, mufc

man_utd

city, mcfc

man_city

spurs

tottenham

villa

aston_villa

forest

nottm_forest

palace

crystal_palace

gunners

arsenal

reds

liverpool

blues

chelsea

barca

barcelona

real

real_madrid

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
  }'

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

Code

Meaning

-32700

Parse error

-32600

Invalid request

-32601

Method not found

-32602

Invalid params

License

MIT License - see LICENSE file.

Available Tools

1 tool
get_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

    B3.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against for patterns or conventions.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides live football match data from Sofascore, including formations, injuries, betting odds, and league positions, enabling natural language queries about matches.
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      11
      15 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      12
      38 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to retrieve soccer match details, live scores, fixtures by date, and win/draw/loss predictions through the Sportmonks Football v3 API.
      285 npm
      MIT