Skip to main content
Glama
billychl1

FootballBin MCP Server

by billychl1
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Hybrid

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)

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

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

Code

Meaning

-32700

Parse error

-32600

Invalid request

-32601

Method not found

-32602

Invalid params

License

MIT License - see LICENSE file.

Links

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/billychl1/footballbin-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server