/api-landing · closed beta

A queryable football API and MCP—with honest limits.

The canonical REST surface and HTTP MCP server are live for invited testers. Coverage, source attribution and verification vary by resource; the methodology page states what is measured today.

No paid plan is currently purchasable. Join the waitlist for supported access, or browse the public website while the evidence ledger and historical completeness programme continue.

Confirmed plans.

Plans and limits are settled; self-serve checkout opens shortly. Paid tiers differ on rate, volume and support only — no data gating between them: the cheapest paid key reads exactly the same rows as the most expensive one.

Free

$0forever

Build something real before you pay.

  • 5,000 requests / month · 30 / minute
  • Current season, 196 competitions (measured 6 Aug 2026)
  • REST API + MCP server
  • No SLA · no bulk export
Compare plans →

Pro

$79/ month

For production apps and research at volume.

  • 2,000,000 requests / month · 600 / minute
  • Everything in Indie
  • Longer query budget · bulk snapshot exports
  • Email support
Compare plans →

Enterprise

Customtalk to us

Custom terms, licensing and support.

  • Custom limits and SLA
  • Redistribution and licensing terms
  • Bulk delivery
  • Direct support
Talk to us →

Why foot.io?

01 · breadth
One canonical model

Multiple upstream identifiers and datasets map into one Postgres schema. Entity aliases and resolvers reduce duplication, while ongoing QA identifies mistaken merges and contamination that automation misses.

02 · depth
Measured depth

Results, events, lineups, statistics, historical odds and modelled metrics share a queryable shape, while nullable fields preserve honest historical gaps instead of implying uniform depth.

03 · LLM-fit
MCP-native

The deployed HTTP MCP endpoint exposes question-shaped tools for agents. Use tools/list for the current surface; tool execution requires an issued beta key.

What is available now?

the current beta contract—not a future sales matrix
SurfaceCurrent statusImportant limit
Public websiteLiveBrowser access; not a third-party API stability contract
REST APIInvite-only closed betaPublic/free preview is current-season for canonical match data; supported historical access needs the project apikey plus an entitled x-api-key
HTTP MCPDiscovery live; execution invite-onlyKeyed tools use the same database content tier; use tools/list for deployed schemas
OpenAPIVersion 3.0.3 specificationDocuments the supported canonical surface, not internal tables
Bulk export / SLANot generally availableContact us for requirements; no advertised entitlement exists yet

Frequently asked.

Can I buy an API plan now?

Not yet. Plans and prices are confirmed — Free $0, Indie $19/mo, Pro $79/mo, Enterprise by arrangement — and self-serve checkout opens shortly. Access is invite-only during closed beta; join the waitlist and we will invite you in order.

What does "MCP-native" mean?

The deployed HTTP MCP endpoint lets compatible agents discover structured football tools. Tool execution uses the same issued beta key as REST. Because the surface evolves, tools/list is authoritative for tool names and input schemas.

What is the public erratum log?

The erratum log publishes confirmed user-facing corrections and their supporting sources. We are extending this into a database-enforced evidence trail so operational repairs cannot bypass the public record.

How complete is the data?

Not uniformly complete. The production database has records from 1871, but only a small number of competitions currently reach before 1900. Events, lineups, advanced statistics, evidence and source URLs are much sparser than scores. Ask about measured coverage for your fields and competition.

How fresh is the data?

Freshness varies by source and ingestion job, and there is no general real-time SLA. Use retrieval metadata where present and ask about the specific dataset if freshness is critical.

Is every fact independently verified?

No. Publisher-aware match and player-season tiers distinguish corroborated, single-source and flagged rows. Corroborated requires two assessed publisher groups; multiple aliases or products from one publisher do not qualify. Tiering does not yet cover every individual field or entity.

Quick start

REST API
Standard PostgREST surface

curl "$FOOTIO_BASE/players?
  name=ilike.*messi*" \
  -H "apikey: $FOOTIO_ANON" \
  -H "x-api-key: $FOOTIO_KEY"

Full docs →

MCP server
HTTP JSON-RPC endpoint

https://amidfjrgsztslrpeaiec
.supabase.co/functions/v1/mcp

Use tools/list for the current surface.

Connect MCP →

OpenAPI 3.0.3
Plug into anything

https://foot.io/openapi-v2.yaml

Canonical beta REST surface,
not internal database tables.

View spec →