# FighterAPI

> The fight data API. 11 MMA data tools for AI agents. REST API + MCP server.

Full reference with response shapes: https://fighterapi.com/llms-full.txt
MCP server setup: https://fighterapi.com/llms-install.md
MCP server for AI agents (clients, prompts, every tool): https://fighterapi.com/mcp
Datasets with live coverage by season: https://fighterapi.com/docs/atlas
Tool catalogue with JSON Schema: https://mcp.fighterapi.com/v1/tools

## Quick Start

- API base URL: https://mcp.fighterapi.com
- Auth: `Authorization: Bearer YOUR_API_KEY` or `x-api-key: YOUR_API_KEY`
- MCP server: `https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY`
- 500 free credits on signup, no credit card required
- REST API responses include `X-Credits-Used` and `X-Credits-Remaining` headers
- Seasons: 4-digit year (cards are grouped by calendar year). Fight ids like 401630119 (an ESPN competition id; list a card's fights with get_event).

## Which Tool Should I Use?

### Static reference
- Cards by year and status, with the main event -> list_events (1 cr)
- Find fighters by name or nickname -> search_fighters (1 cr)

### Basic lookup
- A card's fights with results, method, round, time and judges' scores -> get_event (2 cr)
- Upcoming fights with current moneylines where a book has posted one -> get_schedule (2 cr)
- Our fighter ratings (Elo from every UFC result since 2000) -> get_ratings (2 cr)

### Stats + aggregation
- One fight: result, full stat sheets, round-by-round lines, ratings and odds -> get_fight (5 cr)
- Profile, UFC record by method, career rates, rating and recent fights -> get_fighter (5 cr)
- A fighter's full UFC history with stats, ratings and closing lines -> get_fighter_fights (5 cr)
- Career leaderboards from every fight's stat sheet -> get_leaders (5 cr)
- Opening, closing and current moneylines by sportsbook for a fight (5) or a card (10) -> get_odds (5 cr)

### Time-series
- Daily snapshots of each posted line before a fight -> get_line_movement (10 cr)

## Intents

- "What happened at UFC 298?" -> get_event
- "Which UFC cards were held in 2024?" -> list_events
- "Who is fighting in the next month, and at what price?" -> get_schedule
- "Round by round, how did Volkanovski vs. Topuria go?" -> get_fight
- "What is Ilia Topuria's fighter id?" -> search_fighters
- "How does Topuria fight, in numbers?" -> get_fighter
- "Every UFC fight Topuria has had, with closing lines" -> get_fighter_fights
- "Who lands the most significant strikes per 15 minutes since 2020?" -> get_leaders
- "Who are the highest-rated featherweights right now?" -> get_ratings
- "What did each sportsbook open and close Volkanovski vs. Topuria at?" -> get_odds
- "How did the line move before a fight?" -> get_line_movement

## Pages

- [Docs](https://fighterapi.com/docs): every endpoint, with parameters and a live example response.
- [Data changelog](https://fighterapi.com/changelog): when each dataset was last refreshed and what it runs through, read from the database.
- [Data atlas](https://fighterapi.com/docs/atlas): what exists, which endpoints expose it, and where coverage is partial.
- [Fighters](https://fighterapi.com/fighters): a page per UFC fighter with the record by method, career rates, rating and every fight.
- [Pricing](https://fighterapi.com/pricing): credits per call and what a plan includes.
- [Sign up](https://fighterapi.com/signup): 500 free credits, no card.

### Live odds

- [Upcoming fight odds](https://fighterapi.com/odds): Moneylines for upcoming UFC fights from the sportsbooks ESPN reports, usually one per fight, refreshed daily.

### Other leagues

- [The PFL fight data API](https://fighterapi.com/pfl): PFL fight data since 2012: results with method, round and time for 1,200+ fights, fighter profiles, ratings and sportsbook moneylines. REST and MCP. MCP: https://mcp.fighterapi.com/mcp/pfl
- [The Bellator fight data API](https://fighterapi.com/bellator): Bellator fight data from 2009 to 2024: results with method, round and time for 3,000+ fights, fighter profiles and ratings. REST and MCP. MCP: https://mcp.fighterapi.com/mcp/bellator

### Datasets

- [UFC fight stats data](https://fighterapi.com/data/ufc-fight-stats): The full stat sheet for nearly every UFC fight since 2000: strikes by target and position, takedowns, control time, reversals and submission attempts. REST or MCP.
- [UFC round-by-round stats](https://fighterapi.com/data/round-by-round-stats): Strikes, takedowns, control time and submission attempts for every round of nearly every UFC card since 2000, checked against fight totals. REST or MCP.
- [UFC fighter database](https://fighterapi.com/data/ufc-fighter-database): Every fighter who has fought in the UFC since 2000: date of birth, height, reach, stance, gym, record by method, career rates and our rating. REST or MCP.
- [UFC odds data](https://fighterapi.com/data/ufc-odds): Opening and closing moneylines for UFC fights since 2024, joined to the result and both fighters' stat sheets, with daily line movement for upcoming fights.

### Compared with the alternatives

- [FighterAPI vs scraping UFC Stats](https://fighterapi.com/compare/ufc-stats-scraper): UFC Stats has no API and shows a browser challenge. FighterAPI serves its round data with results, fighters, odds and ratings over REST and MCP.
- [FighterAPI vs the Kaggle UFC datasets](https://fighterapi.com/compare/kaggle-ufc-dataset): Kaggle UFC datasets are free CSV snapshots updated by their authors. FighterAPI serves fight data updated every morning, queried per request.
- [FighterAPI vs Sportradar and SportsDataIO](https://fighterapi.com/compare/sportradar-sportsdataio): Sportradar and SportsDataIO sell licensed, live MMA feeds through sales. FighterAPI serves historical UFC data with self-serve pricing from $19 a month.

### Endpoint pages

- [list_events](https://fighterapi.com/docs/list-events): Cards by year and status, with the main event
- [get_event](https://fighterapi.com/docs/get-event): A card's fights with results, method, round, time and judges' scores
- [get_schedule](https://fighterapi.com/docs/get-schedule): Upcoming fights with current moneylines where a book has posted one
- [get_fight](https://fighterapi.com/docs/get-fight): One fight: result, full stat sheets, round-by-round lines, ratings and odds
- [search_fighters](https://fighterapi.com/docs/search-fighters): Find fighters by name or nickname
- [get_fighter](https://fighterapi.com/docs/get-fighter): Profile, UFC record by method, career rates, rating and recent fights
- [get_fighter_fights](https://fighterapi.com/docs/get-fighter-fights): A fighter's full UFC history with stats, ratings and closing lines
- [get_leaders](https://fighterapi.com/docs/get-leaders): Career leaderboards from every fight's stat sheet
- [get_ratings](https://fighterapi.com/docs/get-ratings): Our fighter ratings (Elo from every UFC result since 2000)
- [get_odds](https://fighterapi.com/docs/get-odds): Opening, closing and current moneylines by sportsbook for a fight (5) or a card (10)
- [get_line_movement](https://fighterapi.com/docs/get-line-movement): Daily snapshots of each posted line before a fight

### Metric definitions

- [Significant strike](https://fighterapi.com/glossary/significant-strike): Any strike thrown at distance, plus power strikes in the clinch and on the ground. Most fight analysis starts here.
- [Rate per 15 minutes](https://fighterapi.com/glossary/strikes-per-15): A count divided by time fought, scaled to 15 minutes: the length of a full three-round fight.
- [Strike defense](https://fighterapi.com/glossary/strike-defense): The share of an opponent's significant strike attempts that did not land, across a fighter's career.
- [Takedown accuracy and defense](https://fighterapi.com/glossary/takedown-accuracy): Takedowns landed over attempted; defense is the share of an opponent's takedown attempts that failed.
- [Control time](https://fighterapi.com/glossary/control-time): Time spent in a dominant position: on top on the ground, or pinning an opponent against the fence in the clinch.
- [Knockdown](https://fighterapi.com/glossary/knockdown): A strike that drops an opponent, a hand or knee touching the canvas, or leaves them visibly out on their feet.
- [Finish rate](https://fighterapi.com/glossary/finish-rate): The share of a fighter's wins that came by knockout, technical knockout or submission rather than on the scorecards.
- [Decisions and scorecards](https://fighterapi.com/glossary/decision): A fight that reaches the final bell is scored by three judges, round by round, on the ten-point must system.
- [Round-by-round stats](https://fighterapi.com/glossary/round-by-round): The fight's stat sheet split into rounds, for each fighter: strikes, takedowns, control and submission attempts.
- [Closing line](https://fighterapi.com/glossary/closing-line): A sportsbook's last price before the fight starts: the market's final, best-informed view of the fight.
- [Implied probability](https://fighterapi.com/glossary/implied-probability): The win chance a moneyline implies, before the sportsbook's margin is taken out.
- [Line movement](https://fighterapi.com/glossary/line-movement): How a fight's price changed between the opening line and the bell, from our daily snapshot of each posted line.
- [Fighter rating (Elo)](https://fighterapi.com/glossary/elo): Our rating of every fighter, updated after each UFC fight from the result alone, starting from 1,500.

### By what you are building

- [Bettors and modellers](https://fighterapi.com/for/bettors): Opening and closing moneylines for UFC fights since 2024, joined to the result, the full stat sheet and both fighters' ratings.
- [Analysts and researchers](https://fighterapi.com/for/analysts): Strikes by target and position, takedowns, control time and submission attempts for nearly every fight and round.
- [Developers and AI builders](https://fighterapi.com/for/developers): REST and MCP over the same data: cards, fights, fighters, stats and odds, with ids that stay stable.