TipMaster consensus feed for AI agents

What real football tippers predict, per match, as JSON and as an MCP server.

The short version. TipMaster is a free football prediction game that people have played since 1997. For every match in the current round, this feed publishes how its players split between home win, draw and away win, the most common exact scores, and the same split for the highest-ranked players. Read-only, no key, aggregates only. REST at /api/agent/v1/consensus, MCP at /api/agent/mcp.

What you get

One record per match. Shares are fractions of the sample and sum to one. Odds are never included; neither is anything about a single player.

{
  "id": "classic:btm:7:1",
  "mode": "classic",
  "competition": "Classic · Bundesliga TipMaster",
  "round": 7,
  "home": "TOP Oss",
  "away": "MVV Maastricht",
  "kickoffUtc": 1791037800,
  "deadlineUtc": 1790956800,
  "status": "open",
  "result": null,
  "sample": 296,
  "skipped": 0,
  "minCohort": 20,
  "outcome": { "home": 0.709, "draw": 0.054, "away": 0.236 },
  "scorelines": null,
  "expert": null,
  "updatedAt": "2026-10-02T06:42:56.780Z",
  "source": "https://tipmaster.net/agents/"
}

Field	Meaning
`mode`	`classic` (weekly, 1X2 tips), `national` or `worldtour` (exact-score tips on real fixtures).
`status`	`open` while tips can still change, `locked` once they cannot, then `played` or `cancelled`.
`sample`	How many players tipped this match. `outcome` stays `null` below 20.
`scorelines`	The three most common exact scores with their share. Exact-score modes only.
`expert`	The same split, counting only ranked players and weighting each by their ranking points.
`deadlineUtc`	When the crowd's picks froze, in unix seconds. Classic: Friday 18:00 Berlin time. Exact-score modes: the matchday deadline.

Endpoints

URL	Returns
`GET /api/agent/v1/consensus?mode=&status=`	Every published match with its consensus.
`GET /api/agent/v1/consensus/{id}`	One match.
`GET /api/agent/v1/matches?mode=&status=`	The matches without the consensus fields.
`GET /api/agent/v1/openapi.json`	The OpenAPI 3.1 document.
`POST /api/agent/mcp`	MCP server, Streamable HTTP, stateless. Tools: `list_matches`, `get_consensus`, `get_crowd_record`.

Quick start

curl

curl -s "https://tipmaster.net/api/agent/v1/consensus?mode=classic" | jq '.matches[0]'

Claude

Add a custom connector with the URL https://tipmaster.net/api/agent/mcp. No login step; the three tools appear at once. Then ask, for example, "Which Bundesliga match this weekend has the clearest crowd favourite?"

Any MCP client

{
  "mcpServers": {
    "tipmaster-consensus": { "url": "https://tipmaster.net/api/agent/mcp" }
  }
}

Python

import requests
r = requests.get("https://tipmaster.net/api/agent/v1/consensus", params={"mode": "classic", "status": "open"})
for m in r.json()["matches"]:
    if m["outcome"]:
        print(m["home"], "-", m["away"], m["outcome"], "n =", m["sample"])

Rules of use

Open access, 60 requests per minute per IP address. Responses carry a 60 second cache header, so there is no point polling faster. Please link to https://tipmaster.net/agents/ wherever you show or cite the numbers; every record carries that URL in its source field. The feed is informational. It is not betting advice and it contains no odds. Use of the feed is subject to the feed terms of use.

Where the numbers come from

Classic players tip 25 matches a round with a Friday 18:00 deadline. Their picks are counted straight from the game's own tip files, so the Classic consensus moves while the round is open, just as members see it inside the game. National and World Tour players tip exact scores on real fixtures chosen each week. Those tips stay private until the matchday deadline, and the feed shows a fixture only after that. The expert cohort uses Weltrang, the game's rolling 52-week ranking, as the weight.

FAQ

Is this betting advice?

No. TipMaster is a free prediction game with no stakes. The feed reports what its players predicted. It carries no odds, no bookmaker data and no recommendation.

Do I need an API key?

No. The feed is open. Each IP address may make 60 requests per minute, and responses can be cached for 60 seconds.

When does a match appear in the feed?

Classic matches appear while tipping is open and update as tips come in. National and World Tour matches appear once their tips are locked, which is five minutes before kickoff at the latest.

Why is outcome sometimes null?

Shares are withheld until at least 20 players have tipped the match. The sample count is always present so you can see how far off that is.

Can I see individual players' tips?

No. The feed publishes aggregates only. No user ids, names or single tips leave the system.

How should I credit the data?

Link to https://tipmaster.net/agents/ wherever you show or cite the numbers. Every record carries that URL in its source field.