FighterAPI is an MCP server published by io.github.noahowsh, hosted at mcp.fighterapi.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 11 tools, including list_events, get_event, get_schedule, get_fight, search_fighters.
UFC fights since 2000, plus PFL and Bellator: results, round stats, fighters and odds. REST and MCP.
20 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Use to find cards. Lists events newest first with the venue, status, number of fights and main event. Filter by season (year) and status (scheduled or final). Costs 1 credit.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max events (default 50). |
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| offset | integer | Page offset; use next_offset. |
| season | ["string","number"] | Year, e.g. 2025. |
| status | string | Only upcoming or only completed cards. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "list_events",
"title": "List events",
"description": "Use to find cards. Lists events newest first with the venue, status, number of fights and main event. Filter by season (year) and status (scheduled or final). Costs 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max events (default 50)."
},
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page offset; use next_offset."
},
"season": {
"type": [
"string",
"number"
],
"description": "Year, e.g. 2025."
},
"status": {
"enum": [
"scheduled",
"final"
],
"type": "string",
"description": "Only upcoming or only completed cards."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"events",
"count"
],
"properties": {
"count": {
"type": "number"
},
"events": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "List events",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for one card: every fight in order with the result, method, round and time, judges' scores and referee. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| event_id * | string | Event id from list_events or get_schedule. |
{
"name": "get_event",
"title": "Event",
"description": "Use for one card: every fight in order with the result, method, round and time, judges' scores and referee. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"event_id"
],
"properties": {
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"event_id": {
"type": "string",
"description": "Event id from list_events or get_schedule."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"event",
"bouts",
"count"
],
"properties": {
"bouts": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"event": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Event",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for upcoming fights: every scheduled bout in the next N days (default 30) with the current moneyline from any book that has posted one. Costs 2 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Days ahead (default 30, max 180). |
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
{
"name": "get_schedule",
"title": "Schedule",
"description": "Use for upcoming fights: every scheduled bout in the next N days (default 30) with the current moneyline from any book that has posted one. Costs 2 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"days": {
"type": "integer",
"maximum": 180,
"minimum": 1,
"description": "Days ahead (default 30, max 180)."
},
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"days",
"bouts",
"count"
],
"properties": {
"days": {
"type": "number"
},
"bouts": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Schedule",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for everything about one fight: the result, both fighters' full stat sheets (strikes by target and position, takedowns, control time, guard passes, reversals, submission attempts; UFC only, null elsewhere and where the source has no sheet), round-by-round lines (UFC only), each fighter's rating before and after, and the opening and closing moneyline from each book that posted one (2024 on). Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| bout_id * | string | Fight id (bout_id) from get_event or get_fighter_fights. |
{
"name": "get_fight",
"title": "Fight",
"description": "Use for everything about one fight: the result, both fighters' full stat sheets (strikes by target and position, takedowns, control time, guard passes, reversals, submission attempts; UFC only, null elsewhere and where the source has no sheet), round-by-round lines (UFC only), each fighter's rating before and after, and the opening and closing moneyline from each book that posted one (2024 on). Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"bout_id"
],
"properties": {
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"bout_id": {
"type": "string",
"description": "Fight id (bout_id) from get_event or get_fighter_fights."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"bout",
"fighters",
"rounds",
"odds"
],
"properties": {
"bout": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"odds": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"rounds": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
{
"type": "null"
}
]
},
"fighters": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"rounds_note": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Fight",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to find a fighter's id by name or nickname (accents optional). Returns weight class, country, pro record, number of fights in the promotion (bouts; ufc_bouts for the UFC only) and last fight date. Costs 1 credit.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results (default 20). |
| query * | string | Name or nickname, e.g. Topuria or 'El Matador'. |
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| weight_class | string | e.g. Lightweight, Women's Strawweight. |
{
"name": "search_fighters",
"title": "Search fighters",
"description": "Use to find a fighter's id by name or nickname (accents optional). Returns weight class, country, pro record, number of fights in the promotion (bouts; ufc_bouts for the UFC only) and last fight date. Costs 1 credit.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results (default 20)."
},
"query": {
"type": "string",
"minLength": 2,
"description": "Name or nickname, e.g. Topuria or 'El Matador'."
},
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"weight_class": {
"type": "string",
"description": "e.g. Lightweight, Women's Strawweight."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fighters",
"count"
],
"properties": {
"note": {
"type": "string"
},
"count": {
"type": "number"
},
"fighters": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Search fighters",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for one fighter's profile: date of birth, height, reach, stance, gym, record in the promotion by method (record; ufc_record is the same for the UFC and null for other promotions), career rates per 15 minutes from the stat sheets (significant strikes landed and absorbed, accuracy, defense, takedowns, submission attempts, control share; UFC only), current and peak rating, and the last five fights. Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| fighter_id * | string | Fighter id from search_fighters. |
{
"name": "get_fighter",
"title": "Fighter",
"description": "Use for one fighter's profile: date of birth, height, reach, stance, gym, record in the promotion by method (record; ufc_record is the same for the UFC and null for other promotions), career rates per 15 minutes from the stat sheets (significant strikes landed and absorbed, accuracy, defense, takedowns, submission attempts, control share; UFC only), current and peak rating, and the last five fights. Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fighter_id"
],
"properties": {
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"fighter_id": {
"type": "string",
"description": "Fighter id from search_fighters."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fighter",
"record",
"ufc_record",
"career_rates",
"rating",
"recent_fights"
],
"properties": {
"rating": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"record": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"fighter": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"ufc_record": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"career_rates": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"recent_fights": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Fighter",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for a fighter's full history in the promotion: every fight with the opponent, result, method, round, time, strikes landed and absorbed and takedowns (UFC only), rating before and after, and the median closing moneyline across sportsbooks. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max fights (default 50). |
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| offset | integer | Page offset; use next_offset. |
| fighter_id * | string | Fighter id from search_fighters. |
{
"name": "get_fighter_fights",
"title": "Fighter fights",
"description": "Use for a fighter's full history in the promotion: every fight with the opponent, result, method, round, time, strikes landed and absorbed and takedowns (UFC only), rating before and after, and the median closing moneyline across sportsbooks. Costs 5 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fighter_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max fights (default 50)."
},
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Page offset; use next_offset."
},
"fighter_id": {
"type": "string",
"description": "Fighter id from search_fighters."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fighter_id",
"fights",
"count"
],
"properties": {
"count": {
"type": "number"
},
"fights": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"fighter_id": {
"type": "string"
},
"next_offset": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"title": "Fighter fights",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for career leaderboards computed from every fight's stat sheet: sig_landed_per_15 (significant strikes landed per 15 min), sig_absorbed_per_15 (significant strikes absorbed per 15 min), sig_accuracy (significant strike accuracy), sig_defense (significant strike defense), td_per_15 (takedowns landed per 15 min), td_accuracy (takedown accuracy), td_defense (takedown defense), knockdowns (knockdowns), sub_attempts_per_15 (submission attempts per 15 min), control_share (share of fight time in control), finish_rate (wins by KO/TKO or submission, as a share of wins). Filter by weight class, a starting year, and a minimum number of fights (default 5). Costs 5 credits.
| Parameter | Type | Description |
|---|---|---|
| stat * | string | Which leaderboard. |
| limit | integer | Max fighters (default 20). |
| since | ["string","number"] | Only fights from this year on, e.g. 2020. |
| min_fights | integer | Minimum fights to qualify (default 5). |
| weight_class | string | Only fights in this weight class, e.g. Lightweight. |
{
"name": "get_leaders",
"title": "Leaders",
"description": "Use for career leaderboards computed from every fight's stat sheet: sig_landed_per_15 (significant strikes landed per 15 min), sig_absorbed_per_15 (significant strikes absorbed per 15 min), sig_accuracy (significant strike accuracy), sig_defense (significant strike defense), td_per_15 (takedowns landed per 15 min), td_accuracy (takedown accuracy), td_defense (takedown defense), knockdowns (knockdowns), sub_attempts_per_15 (submission attempts per 15 min), control_share (share of fight time in control), finish_rate (wins by KO/TKO or submission, as a share of wins). Filter by weight class, a starting year, and a minimum number of fights (default 5). Costs 5 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stat"
],
"properties": {
"stat": {
"enum": [
"sig_landed_per_15",
"sig_absorbed_per_15",
"sig_accuracy",
"sig_defense",
"td_per_15",
"td_accuracy",
"td_defense",
"knockdowns",
"sub_attempts_per_15",
"control_share",
"finish_rate"
],
"type": "string",
"description": "Which leaderboard."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max fighters (default 20)."
},
"since": {
"type": [
"string",
"number"
],
"description": "Only fights from this year on, e.g. 2020."
},
"min_fights": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Minimum fights to qualify (default 5)."
},
"weight_class": {
"type": "string",
"description": "Only fights in this weight class, e.g. Lightweight."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"stat",
"label",
"min_fights",
"leaders",
"count"
],
"properties": {
"stat": {
"type": "string"
},
"count": {
"type": "number"
},
"label": {
"type": "string"
},
"leaders": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"min_fights": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Leaders",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for our fighter ratings: an Elo built from the promotion's own results (the UFC since 2000), highest first, for fighters active since a given year (default last year). Filter by weight class. Costs 2 credits.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max fighters (default 25). |
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| active_since | ["string","number"] | Only fighters whose last fight was in this year or later. |
| weight_class | string | e.g. Welterweight. |
{
"name": "get_ratings",
"title": "Ratings",
"description": "Use for our fighter ratings: an Elo built from the promotion's own results (the UFC since 2000), highest first, for fighters active since a given year (default last year). Filter by weight class. Costs 2 credits.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Max fighters (default 25)."
},
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"active_since": {
"type": [
"string",
"number"
],
"description": "Only fighters whose last fight was in this year or later."
},
"weight_class": {
"type": "string",
"description": "e.g. Welterweight."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"active_since",
"ratings",
"count",
"method"
],
"properties": {
"count": {
"type": "number"
},
"method": {
"type": "string"
},
"ratings": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"active_since": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Ratings",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use for betting lines: each posted sportsbook's opening, closing and current moneyline for both fighters, with implied probabilities and the total-rounds line. Opening and closing lines start with the UFC cards of June 2020; a median of 5 to 7 books per fight (some fights since mid-2024 have only one book). Pass bout_id for one fight (5 credits) or event_id for a whole card (10 credits). Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| bout_id | string | One fight. |
| event_id | string | A whole card. |
{
"name": "get_odds",
"title": "Odds",
"description": "Use for betting lines: each posted sportsbook's opening, closing and current moneyline for both fighters, with implied probabilities and the total-rounds line. Opening and closing lines start with the UFC cards of June 2020; a median of 5 to 7 books per fight (some fights since mid-2024 have only one book). Pass bout_id for one fight (5 credits) or event_id for a whole card (10 credits). Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"bout_id": {
"type": "string",
"description": "One fight."
},
"event_id": {
"type": "string",
"description": "A whole card."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string"
},
"tool": {
"type": "string"
},
"bouts": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"count": {
"type": "number"
},
"credits": {
"type": "number"
},
"estimate_only": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Odds",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Use to see how a fight's line moved before the bell: our snapshots of each posted moneyline, from first capture to fight day (once a day from October 2026, and every hour in the four days before). Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.
| Parameter | Type | Description |
|---|---|---|
| league | string | League. Defaults to mma. One of: mma, pfl, bellator. |
| bout_id * | string | Fight id. |
| provider | string | One sportsbook, e.g. DraftKings. |
| all_snapshots | boolean | Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time. |
{
"name": "get_line_movement",
"title": "Line movement",
"description": "Use to see how a fight's line moved before the bell: our snapshots of each posted moneyline, from first capture to fight day (once a day from October 2026, and every hour in the four days before). Costs 10 credits. Prices are market information; no tool places, accepts or tracks wagers.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"bout_id"
],
"properties": {
"league": {
"enum": [
"mma",
"pfl",
"bellator"
],
"type": "string",
"description": "League. Defaults to mma. One of: mma, pfl, bellator."
},
"bout_id": {
"type": "string",
"description": "Fight id."
},
"provider": {
"type": "string",
"description": "One sportsbook, e.g. DraftKings."
},
"all_snapshots": {
"type": "boolean",
"description": "Every hourly capture. By default a capture identical to the one before it is left out (the latest is always kept), which keeps every move and its time."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"bout",
"movement",
"snapshots"
],
"properties": {
"bout": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"note": {
"type": "string"
},
"movement": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"snapshots": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Line movement",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}FighterAPI -- 11 fight data tools. Every UFC fight since 2000: results, stat sheets and fighters, with rounds for UFC cards (Dana White's Contender Series cards have none, and the newest card's rounds can lag by days); moneylines from June 2020. ## First Steps 1. Find a fighter's id with search_fighters (1 cr), or a card's id with list_events (1 cr) / get_schedule (2 cr). 2. Fight ids (bout_id) come from get_event or get_fighter_fights. 3. Seasons are calendar years (2025). ## Tool Selection - Find a fighter by name -> search_fighters (1 cr) - Find cards by date or season -> list_events (1 cr) - A card and its results -> get_event (2 cr) - Upcoming fights with today's lines -> get_schedule (2 cr) - Everything about one fight: stat sheets, round-by-round, ratings, odds -> get_fight (5 cr) - A fighter's profile, record by method and career rates -> get_fighter (5 cr) - A fighter's whole UFC history -> get_fighter_fights (5 cr) - Who leads a stat (strikes, takedowns, defense, control, finishes) -> get_leaders (5 cr) - Our ratings, best first -> get_ratings (2 cr) - Opening and closing moneylines by sportsbook -> get_odds (5 cr a fight, 10 a card) - How a line moved before the fight -> get_line_movement (10 cr) ## Notes - Rates are per 15 minutes of fighting time. Accuracy and defense are fractions (0.52 = 52%). - Round-by-round lines are checked against the fight totals for every fight; a fight where the two disagree says so in rounds_note. - Opening and closing moneylines start with the UFC cards of June 2020: a median of 5 books per fight in 2020 and 6 to 7 since (Pinnacle, FanDuel, BetOnline, DraftKings, BetMGM, Bovada, MyBookie and ESPN BET). More lines are added from the November 2023 cards, usually one book per fight. There are no opening or closing lines before June 2020. Prices are American odds; *_prob fields are implied probabilities with the book's margin in them. - Ratings are ours: Elo from UFC results alone, not a ranking. ## Credit costs | Credits | Tools | |---|---| | 1 | list_events, search_fighters | | 2 | get_event, get_schedule, get_ratings | | 5 | get_fight, get_fighter, get_fighter_fights, get_leaders, get_odds | | 10 | get_line_movement | ## Data timing and rights - Odds and props are pre-game only. captured_at is when a line was captured (the page says exactly what it means for each kind of row); where props are held, rows also carry scheduled_start and minutes_before_scheduled_start (negative when captured after the scheduled start). - Records are overwritten when sources correct them; no revision history is kept. - You may store the data, train models, backtest, and build commercial products that show your users what you derive. You may not redistribute the data, or odds as a raw feed, as a dataset or API of its own. After an account closes, stored data is for internal use only. - FighterAPI is independent, not an official league partner, and grants no league rights. - Full answers: https://fighterapi.com/docs/timing-and-rights ## Sportsbook prices are information Show lines and prices as data about the market. Do not work out a stake, payout or profit for a wager, recommend a bet, or send the user to a sportsbook. No tool places, accepts or tracks wagers; if asked to bet, say so and offer the data instead.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.