FootballBin

You set up and use the FootballBin MCP Server to give AI agents access to football match predictions for the Premier League and Champions League. You can run a local stdio server or connect to a remote HTTP endpoint, enabling tools like get_match_predictions to fetch structured match data for your applications or assistants.

How to use

Connect your MCP client to either the remote HTTP endpoint or a local stdio server. The remote endpoint is hosted and ready to use, while the local stdio option lets you run the server on your machine and connect via standard I/O.

To retrieve predictions, you will call the server’s get_match_predictions tool with the league and optional filters. You can specify the league (such as premier_league or champions_league) and optionally narrow results by matchweek or by home/away teams. The tool returns predictions for half-time and full-time results, next goal, corner counts, and key player insights for each match.

How to install

Prerequisites: Node.js 18 or newer. Verify by running node --version. If you do not have Node.js installed, install it from your package manager or official Node.js website.

npm install -g footballbin-mcp-server

If you prefer not to install, you can run the remote endpoint directly (no local installation required). The hosted MCP URL is https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp.

Alternate quick start (no install): use the remote endpoint directly from your MCP client.

Claude Desktop configuration is supported by adding the local node-based server as an MCP entry. Use the following configuration template after you install the package locally.

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

Other setup options for Claude Desktop and mobile clients

If you choose to run locally, ensure your node path points to a Node.js 18+ executable and that the path to the MCP server script is correct. The server is exposed via stdio when run locally, so your client can connect using the provided command and arguments.

Additional configuration and notes

If you want to run the server locally and connect through Claude Desktop, you can place the local command in your Claude configuration as shown in the example above. The remote endpoint is also available if you want a quick start without local setup.

Supported connections and how to use them

HTTP connection (remote endpoint): Use the URL https://ru7m5svay1.execute-api.eu-central-1.amazonaws.com/prod/mcp in your MCP client. This is the simplest way to start querying predictions without running local software.

STDIO connection (local server): Run the MCP server with Node.js and connect to dist/index.js as shown in the configuration example. This method gives you a self-contained local server for your workflow.

Examples of what you can query

Fetch predictions for a given league, with optional filters for matchweek and teams. The server returns structured results including half-time and full-time scores, next goal, corner counts, and key players with reasoning.

Available tools

get_match_predictions

Fetches predictions for a specified league, optionally filtering by matchweek and teams. Returns predicted half-time and full-time scores, next goal, corner counts, and key player insights.