Skip to main content
Glama
billychl1

FootballBin MCP Server

by billychl1
OverviewInspectSchemaRelated 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.

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 Desktop

Add to your claude_desktop_config.json:

{ "mcpServers": { "footballbin": { "command": "npx", "args": ["-y", "footballbin-mcp-server"] } } }

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Troubleshooting: If the server fails to connect, try installing globally first:

npm install -g footballbin-mcp-server

Then use this config:

{ "mcpServers": { "footballbin": { "command": "footballbin-mcp-server" } } }

Claude.ai (Remote)

  1. Go to Settings > Connectors

  2. Click Add custom connector

  3. Enter: 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

This server cannot be installed

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