API & MCP

Everything a person can do on Game Event Replay, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://fielddaygamereplay.usefulweb.site/api/v1/calculate – run Game Event Replay
GET https://fielddaygamereplay.usefulweb.site/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Game Event Replay

Replay your own match events with named teams, score corrections, lead changes, tied scores and an explicit match duration.

Inputs of Game Event Replay
Field	Type	Default	Description
`events`	table	[{"minute":3,"second":20,"team":"home","points":1,"note":"Goal"},{"minute":8,"se	Game events
`homeName`	text	"Home"	Home team
`awayName`	text	"Away"	Away team
`durationMinutes`	number	0	Match duration (minutes, 0 = last event)

Example request

Try an example

curl -X POST https://fielddaygamereplay.usefulweb.site/api/v1/calculate -H 'content-type: application/json' -d '{}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://fielddaygamereplay.usefulweb.site/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: fieldday_game_replay
Local stdio connector: node src/mcp-stdio.ts --tool=fieldday-game-replay

{
  "mcpServers": {
    "fieldday-game-replay": { "type": "http", "url": "https://fielddaygamereplay.usefulweb.site/mcp" }
  }
}