Server data from the Official MCP Registry
Football match outcome probabilities recorded before kick-off, and an open record of results.
About
Football match outcome probabilities recorded before kick-off, and an open record of results.
Security Report
This is a well-designed read-only MCP server with excellent security practices. It provides access to a public football analytics API with no authentication requirements, implements proper input validation, strict output whitelisting, caching/throttling to protect the upstream API, and clear documentation. Minor code quality observations exist but do not materially affect security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity).
4 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-aiballfooty-aiball-mcp": {
"args": [
"-y",
"aiball-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
AI Ball MCP server
Read-only Model Context Protocol server for AI Ball, AI football match analysis.
It gives an AI assistant two things:
- Pre-kick-off outcome probabilities. For each match, the model's home / draw / away probabilities as recorded before kick-off.
- The open record. What happened afterwards: the final score and whether the model's most likely outcome came in. Misses are counted the same way as hits, and nothing is removed after the fact.
No account, no API key. The server only calls AI Ball's public record API.
Tools
| Tool | What it returns |
|---|---|
list_matches | One calendar day: match_id, kick-off time, league, teams and status (upcoming, pending or finished) |
get_match_analysis | One match: home / draw / away probabilities recorded before kick-off, the most likely outcome, confidence, when the read was captured, and once played the score and whether it came in |
get_open_record | The whole record, or one week with week_start: matches counted, how many went the model's way, two baselines on the same matches, and the count by confidence band |
Every tool is read-only (readOnlyHint: true). Names are available in English (lang: "en") and Malay (lang: "ms"). Responses are built from a fixed list of fields; nothing from the upstream API is passed through as-is.
Reading the numbers
models.balancedholds fractions forhome,drawandawaythat sum to 1. This version returns the balanced model;models_availablelists what is included.result.hitistruewhen the model's most likely outcome happened.hit_rateis a percentage.nullmeans the sample is undermin_band_sample, so use the countshitsandninstead.favourite_baselinescores the same matches by always taking the pre-match favourite;random_baselineis one outcome in three.upcomingmatches are locked before kick-off.pendingmatches carry a current read that may still change.
The server caches each upstream response for five minutes and spaces its requests, so repeated questions do not hit AI Ball's API again.
Install
Claude Desktop
Download aiball-mcp.mcpb from the latest release and open it.
Claude Code
claude mcp add aiball -- npx -y github:aiballfooty/aiball-mcp
Cursor, VS Code and other clients
{
"mcpServers": {
"aiball": {
"command": "npx",
"args": ["-y", "github:aiballfooty/aiball-mcp"]
}
}
}
Requires Node.js 18 or later.
Example questions
- "How did AI Ball's model do on last week's matches?"
- "Which of last week's matches did the model get wrong?"
- "What are the model's probabilities for today's matches, in Malaysia time?"
- "Across the whole record, does the model do better than always taking the favourite?"
Privacy
The server runs on your machine and sends requests only to https://aiball.samagent.ai/api/v1. Requests carry the tool's parameters (a date, a time zone, a language) and a User-Agent of aiball-mcp/<version>. They do not carry your conversation, your files or any identifier. AI Ball's web server keeps standard access logs. Site privacy policy: https://aiball.samagent.ai/en/privacy
Development
npm install
npm test # starts the server and calls every tool against the live API
Set AIBALL_API_BASE to point the server at another base URL.
Licence
MIT. For information only. Not advice. 18+.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Worldmonitor
Freeby Koala73 · Developer Tools
Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 86 tools.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.