GoalGorithm

Provides soccer match predictions and league insights using xG data and Poisson modeling via MCP tools.

python

0

GitHub Stars

python

Language

3 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tohoanganhai-goalgorithm-mcp": {
      "command": "uvx",
      "args": [
        "goalgorithm-mcp"
      ]
    }
  }
}

You can run the GoalGorithm MCP Server to generate soccer match predictions using xG data and a Poisson model, exposed as MCP tools for Claude Desktop or Code. This server provides practical prediction outputs, league tables, and configurable data sources to power your match analysis workflows.

How to use

You will interact with the MCP server through an MCP client or Claude integration. After starting the server, you can request predictions for matches, fetch league tables, and explore available leagues. Use natural language prompts or the explicit tool names to trigger actions, for example asking for a match prediction or requesting a league table.

How to install

Prerequisites: Python and a compatible MCP runtime (such as UVX) installed on your system.

pip install goalgorithm-mcp

Additional setup and usage notes

Enable Claude Desktop integration by adding an MCP server entry to your Claude Desktop configuration. The example below registers a local MCP server command that starts the MCP server and makes it available to Claude.

{
  "mcpServers": {
    "goalgorithm": {
      "command": "goalgorithm-mcp"
    }
  }
}

How to run the MCP server

You can run the MCP server directly using the following commands. Choose the approach you prefer based on your environment.

uvx goalgorithm-mcp

Tools and endpoints you can use

The MCP server exposes practical tools you can call through your MCP client. These tools allow you to predict match outcomes, list leagues, and retrieve league tables.

Example usage in Claude

After configuration, you can ask Claude for match predictions. Example prompts include requesting a prediction for a specific match or asking for a league table.

Supported tools

predict_match: Predict soccer match outcomes using xG-based Poisson modeling and provide a score matrix, probability distributions, and key metrics.
get_league_table: Retrieve teams in a league with xG statistics, sorted by attacking strength.
list_leagues: List all supported leagues with IDs and slugs.

Available tools

predict_match

Predict soccer match outcomes using an xG-based Poisson model, returning win/draw/loss percentages, over/under 2.5 goals, BTTS, top scores, expected goals, and a score matrix.

list_leagues

List all supported leagues with IDs and slugs to identify available competitions.

get_league_table

Fetch league-wide xG statistics and attacking strength ranking for all teams in a league.