Runs on the free plan No code 4 API calls

Build an AI football assistant

Connect Claude, ChatGPT or Cursor to the API and ask about fixtures, tables, corners and odds in plain language. No code, no install.

Get your free API key View on GitHub

What it looks like

ChatGPT ranking Premier League teams by corners per match. It called the standings tool itself and built the table from the answer.

ChatGPT answering with a table of Premier League teams ranked by corners won per match, read from the football API through the MCP server

The API calls behind it

1
search_leagues
The assistant finds the league id by name. Behind it: GET /v1/leagues. Reference →
2
get_standings
League, corner or card table. Behind it: GET /v1/standings. Reference →
3
get_fixtures
A day's fixtures with live scores, corners and cards. Behind it: GET /v1/fixtures. Reference →
4
get_fixture_odds
Current odds for a match across the markets. Behind it: GET /v1/fixtures/{id}/odds. Reference →

What it takes to run

Works with a free key — no card needed. The assistant sees what your plan sees: the top-5 leagues on Free.
Every tool call the assistant makes is one request against your plan. The free plan allows 60 requests / hour.
The odds history tool needs the Ultra plan, like the endpoint behind it.

Compare plans

Set it up

The server is hosted, so there is nothing to install.

1

Create a key for the assistant

Sign up free and create a separate API key in your dashboard. The connector address will contain it, so it should not be the key your own code uses.
2
Claude or ChatGPT: add a custom connector

In the connector settings, add a remote MCP server with this address, your key as the last part.
```
https://mcp.5dollarfootballapi.com/mcp/fb_live_your_key
```

Or: Claude Code, Cursor and other clients that send headers

Add the server with your key in the Authorization header instead.

claude mcp add --transport http football-api https://mcp.5dollarfootballapi.com/mcp --header "Authorization: Bearer fb_live_your_key"

Ask

Then ask in plain language. For example:

Which Premier League teams win the most corners per match this season?
What matches are live right now, and what are the scores?
Show me the Bet365 odds for tonight's La Liga games.

The server is open source: 5dollarfootball-api/football-api-mcp →

Take it further

The server gives the assistant 11 read-only tools, from fixtures and standings to the full odds history.
It also ships three ready-made prompts: a daily briefing, an odds movement report and a corner scout.
Prefer to run it yourself? The same server is on npm as football-api-mcp.
Revoke the key from your dashboard if the address ever leaks; your other keys keep working.

The data behind this example

Corner Stats API

The corner data other APIs skip: full-time and half-time corner counts, corner-l...

Live Scores API

Poll real-time football scores, in-play status, goals, corners and cards across...

Football Odds API

One endpoint for European 1X2, Asian handicap, goal line, corner and card odds —...

Frequently asked questions

No. The MCP server is hosted at mcp.5dollarfootballapi.com. You paste one address into your assistant's connector settings and it can query the API from then on.

Yes. The assistant reads the same data your key does: the top-5 leagues on Free, 130+ competitions on Pro and every league on Ultra. Each tool call counts as one request; the free plan allows 60 requests / hour.

No. All 11 tools are read-only: fixtures, live scores, standings, odds, odds history and your own usage. Because the connector address contains your key, use a separate key for it and revoke that key if the address ever leaks.

Start building for free

Get a working API key in under a minute. No credit card, no sales call.

Get your free API key Read the docs