Servers Playground How we check Add a server Log in

FighterAPI

Working · 1.6 s

io.github.noahowsh/fighterapiv1.1.6

UFC fights since 2000, plus PFL and Bellator: results, round stats, fighters and odds. REST and MCP.

Entertainment & Games

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.fighterapi.com/mcp

x-api-key (required)

Your FighterAPI API key. Get a free key (500 credits every month) at fighterapi.com/signup

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_event Read-only

Use for one card: every fight in order with the result, method, round and time, judges' scores and referee. Costs 2 credits.

event_idstring, required

Event id from list_events or get_schedule.

leaguestring

League. Defaults to mma. One of: mma, pfl, bellator.

FighterAPI MCP server | mcptry

Tools (11)

get_event

Use for one card: every fight in order with the result, method, round and time, judges' scores and referee. Costs 2 credits.

read-only

Argument	Type	Description
league	string	League. Defaults to mma. One of: mma, pfl, bellator.
event_id*	string	Event id from list_events or get_schedule.

Input schema (JSON)

{
  "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."
    }
  }
}

get_fight

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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_fighter

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.

read-only

Argument	Type	Description
league	string	League. Defaults to mma. One of: mma, pfl, bellator.
fighter_id*	string	Fighter id from search_fighters.

Input schema (JSON)

{
  "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."
    }
  }
}

get_fighter_fights

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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_leaders

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_line_movement

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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_odds

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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
league	string	League. Defaults to mma. One of: mma, pfl, bellator.
bout_id	string	One fight.
event_id	string	A whole card.

Input schema (JSON)

{
  "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."
    }
  }
}

get_ratings

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

get_schedule

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: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

read-only

Argument	Type	Description
days	integer	Days ahead (default 30, max 180).
league	string	League. Defaults to mma. One of: mma, pfl, bellator.

Input schema (JSON)

{
  "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."
    }
  }
}

list_events

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}

search_fighters

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.

read-only

Argument	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.

Input schema (JSON)

{
  "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."
    }
  }
}