Documentation / Assistants and agents

FOOTBALL API AGENT SKILL

Agent skill

One file that teaches an AI agent to use Football API well: what it is for, how the key is sent, which call answers which question, the limits, what each refusal means, and the order to work in. Add it once and the agent reads it whenever a football question comes up.

Download skill.md Open it

ADD IT

mkdir -p ~/.claude/skills/footballapi
curl -o ~/.claude/skills/footballapi/SKILL.md https://footballapi.org/skill.md

WHERE IT LIVES

/skill.mdmarkdownThe skill, for people and links.

/.well-known/agent-skills/footballapi/SKILL.mdmarkdownThe same file, where agents look.

/.well-known/agent-skills/index.jsonjsonThe index agents read first, with the file's fingerprint.

WHAT IS IN IT

---
name: footballapi
description: Answer football questions from Football API (footballapi.org): results, fixtures, league tables on any date, club form, head to head, grounds and live scores for sixty leagues and the European and world competitions since 2015/16. Use for any question about a football match, season, table or club.
---

# Football API

Football results, fixtures, league tables on any date, club form, head to head, grounds and live scores, as JSON at `https://api.footballapi.org/v1`. Sixty leagues in thirty countries, the European club competitions, the World Cup and the Euros, every season back to 2015/16.

## When to use it

Use it for a fact about a match, a season, a table or a club in that collection: a score, a run of results, who plays next, where a club stood on a date, a club's form, a head to head. Do not use it for odds, betting prices, line-ups or player statistics: it does not serve them.

## Access

- A complimentary key comes from signing in with Google at https://footballapi.org/key. It reads this season's Premier League.
...

It is built from the same list as these pages, so it changes when an endpoint, a limit or a tool does.

PREVIOUSMCP tools NEXTThe manual