Connecting football data to AI assistants with MCP
How the read-only FootballAPI.net MCP connection lets compatible AI clients look up football data with scoped, revocable access.
FootballAPI.net editorial team
Written and reviewed by the organisation
Published 30 Oct 2026Updated 1 Nov 20265 min read

The Model Context Protocol, usually shortened to MCP, lets compatible AI clients call external tools in a structured way. Instead of pasting tables into a chat, a user can connect a data source and let the client request what it needs. FootballAPI.net offers a read-only MCP connection so compatible clients can look up fixtures, tables, teams and players from qualified feeds.
This guide explains the read-only MCP connection for compatible external AI clients. MCP is a Pro feature and remains subject to account entitlement, saved league access and the published tools. It is separate from the site's Ask AI support box: one reads permitted football data through tools, while the other explains public product documentation.
What the connection provides
The connection exposes a small set of read-only tools, each mapped to a qualified feed. A client can ask for a competition's standings, a team's profile or a player's record by identifier, and receive structured data back. Tools never write anything, never place transactions and never reach feeds that are not enabled for your account.
Calls through MCP count towards your usage like any other request, and they appear on your usage page.
Our MCP documentation lists the current tools. If the server is unreachable, the documentation shows a fallback list so you can still plan.
- Read-only tools mapped to qualified feeds
- Counts towards normal usage
- No writes and no transactions
Connecting a client
From the connect AI page in your dashboard, you start an authorisation flow from your client. You sign in, review the requested access on a consent page and approve it. The client receives a scoped token tied to your account. You can see and revoke connections at any time from the same page.
Revocation takes effect immediately. If you stop using a client or suspect misuse, revoke and reconnect later if needed.
Keeping answers grounded
AI clients can summarise data fluently and also make mistakes. Encourage users to ask for the underlying figures, check identifiers and treat summaries as drafts. When a feed is not available, the tool returns a clear error, and a well-behaved client should say that the data is unavailable rather than inventing it.
The data contains no predictions of results, and the tools do not offer tips. A client asked who will win should be able to show tables and recent results, but any forecast is the client's own speculation, not FootballAPI.net data.
Privacy and scope
The connection only reads football data. It does not expose your API keys, billing details or other account information to the client. Tokens are scoped to the MCP tools and can be revoked. Review what your chosen client does with tool results, since its own privacy policy governs that.
Limits and costs
AI clients can make several data calls per question. MCP requires Pro, which includes 250,000 successful requests per day; normal account usage rules apply. The inclusion resets at midnight UTC, with metered extras at €0.002 each and a shared safety limit of 100 requests per second. Cache reusable results and monitor usage after connecting a new client. A large daily allowance is not permission for unlimited concurrent calls.
- Several calls per question are normal
- Monitor the usage page early
- Prefer specific questions
Our documentation assistant is different
The site's Ask AI box uses an AI model grounded in public guides, published endpoint parameters and current product settings. It can explain integration steps and cite documentation, but it cannot inspect your private invoices, recover keys or change an account. MCP is different: it lets a compatible external AI client call permitted read-only football tools after you authorise the connection.
Good uses
Analysts can ask for a team's season statistics and get structured figures to explore. Editors can check a table or a fixture date quickly. Developers can prototype queries before writing code. In each case the value comes from fast, accurate lookups, not from the client's opinions.
A worked example
An editor connects a compatible client, approves the consent page and asks for the current table of league 1204. The client calls the standings tool, receives the rows and formats them. The editor then asks for team 9260's profile, and the client calls the team tool. Both calls appear on the usage page. At the end of the week, the editor revokes the connection from the dashboard.
Writing good questions
Specific questions produce better and cheaper results. Ask for the standings of a named competition and season rather than asking how a league is going. Ask for a team by name and let the client confirm the identifier. When the answer includes figures, ask the client to show the raw rows it used, which makes errors easy to spot.
If the client cannot find a competition, check the directory yourself and give it the identifier. Clients sometimes guess identifiers, and a wrong guess can return a valid response for the wrong competition.
Avoid open-ended requests to analyse everything about a club. They trigger many tool calls, consume usage quickly and rarely produce better insight than a few targeted lookups.
For teams and organisations
If several colleagues use AI clients, each should connect under their own account so usage and revocation are individual. Agree internal guidance on how AI summaries may be used in published work: for example, that every figure must be checked against the stored data before publication. The connection is a fast research tool, not a substitute for editorial checks.
Review active connections monthly and revoke any that are no longer needed.
When tools return errors
A tool may return an error because a feed is not enabled for your account, a parameter is wrong or a limit was reached. Good clients relay that message plainly. If yours instead produces an answer anyway, treat the answer as unreliable and check the usage page for the failed call, which records the status code returned.
Key takeaways
- MCP gives compatible clients read-only, revocable access to qualified feeds.
- MCP requires Pro; successful data calls use the same account usage and billing rules as API requests.
- Treat AI summaries as drafts and keep forecasts separate from data.
Feed-family explorer
What each family covers, with links to the documentation that defines it. Labels reflect provider sampling, not production promises.
Scores and fixtures
Sampled- Today's matches grouped by competition
- Season fixtures with static match IDs
- Status strings preserved as supplied
Frequently asked questions
Can the MCP connection change my account or data?
No. All tools are read-only.
Do MCP calls count towards usage?
Yes, like any other request, and they appear on your usage page.
Is the site's support chat an AI?
Yes. Ask AI uses an AI model grounded in public documentation and current product settings. It is not an account-management agent and cannot inspect private payments or take account actions. It is separate from the Pro MCP integration.
How do I disconnect a client?
Revoke it from the connect AI page in your dashboard. It takes effect immediately.
Sources and references
- Configure an authorised read-only MCP client
- Review Pro plan access and request allowances
- FootballAPI.net API reference
- FootballAPI.net coverage notes
Use these implementation references alongside this guide. Current endpoint parameters and account settings take precedence over illustrative examples.
Related guides
All guidesAPI key security and data licensing for football products
Practical rules for protecting API keys and staying within display and redistribution terms when building with football data.
Football API pricing: plans, daily allowances and overage billing
Compare monthly euro plans, league access and daily successful requests, with worked examples for UTC resets, shared account usage and €0.002 overage billing.
What is a football API?
A plain explanation of what a football data API does, what it returns, and what it cannot honestly promise.