ExactScore AI API and MCP server

Overview

Every prediction on the site is also available as JSON: upcoming calls with the predicted score and goalscorers, graded results, the reasoning and the aggregate track record. The API is read-only, free and needs no key or account. The same data is exposed as tools to AI agents through an MCP server.

Endpoints

GET /api/v1/info — Name, prediction model, last data update, contact and links to docs, OpenAPI and MCP.
GET /api/v1/competitions — Competitions in the catalog. covered=true when the site already has predictions for it.
GET /api/v1/predictions — Predictions with the predicted score and goalscorers. status=pending returns upcoming calls soonest first; otherwise newest kickoff first. Query: competition, status (pending | settled), limit (1-100), offset.
GET /api/v1/predictions/{id} — One prediction with reasoning, real scorers, grade and every revision made before kickoff.
GET /api/v1/stats — Hit rates computed from every graded prediction: outcome (1X2), exact score and tipped goalscorers. Query: competition.

List endpoints return at most 100 items per page: use limit and offset to page through the rest.

curl -s "https://exactscoreai.com/api/v1/predictions?status=pending&limit=5"

curl -s "https://exactscoreai.com/api/v1/stats?competition=world-cup-2026"

Authentication and rate limits

No authentication. Each IP address can make 120 requests per 60 seconds across the API and the MCP server. Every response carries the IETF RateLimit-Policy and RateLimit headers (remaining requests and seconds until the window resets). Over the limit the API answers 429 with a Retry-After header.

RateLimit-Policy: "default";q=120;w=60
RateLimit: "default";r=118;t=42

Errors

Errors under /api/ are returned as application/problem+json (RFC 9457) with the fields type, title, status, detail, code and resolution. The code is stable and machine-readable: bad_request, not_found, method_not_allowed, voting_closed, rate_limited or unavailable.

{
  "type": "https://exactscoreai.com/docs/#errors",
  "title": "Not Found",
  "status": 404,
  "detail": "No prediction with id \"abc\".",
  "code": "not_found",
  "resolution": "List valid ids with GET /api/v1/predictions."
}

MCP server

The MCP endpoint speaks JSON-RPC 2.0 over Streamable HTTP (POST /mcp). Add it to any MCP client as a remote server with the URL https://exactscoreai.com/mcp. Resources: exactscore://track-record and exactscore://upcoming (JSON). Tools:

get_site_info — Name, prediction model, last data update, contact and links of ExactScore AI.
list_competitions — Football competitions in the catalog and whether they already have predictions.
list_predictions — Predicted exact scores and tipped goalscorers. status=pending: upcoming matches, soonest first. status=settled: graded matches with the real result.
get_prediction — One prediction by id: scoreline, goalscorers, reasoning, revision history and, once played, result and grade.
get_track_record — Accuracy of all graded predictions: outcome (1X2), exact score and goalscorer hit rates.

curl -s https://exactscoreai.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_predictions","arguments":{"status":"pending","limit":3}}}'

Markdown pages

Every main page (home, track record, competition hubs, match pages, about, contact, privacy and this page) is also available as markdown: add .md to its URL without the trailing slash (/track-record.md, /predictions/serie-a.md, /index.md for the home page).

curl -s https://exactscoreai.com/index.md

Terms of use

The data is free to use in apps, bots and articles; please link back to exactscoreai.com as the source. Predictions are AI-generated opinions for entertainment and analysis, not betting advice. 18+ only. Questions: see the contact page.