Skip to main content
Glama

FighterAPI

Server Details

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

Ownership verified
Status
Healthy
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
noahowsh/fighterapi-mcp
GitHub Stars
0

TDQS

Score is being calculated.

Available Tools

11 tools
get_event
Read-only
Inspect

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

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
event_idYesEvent id from list_events or get_schedule.

Output Schema

ParametersJSON Schema
NameRequiredDescription
boutsYes
countYes
eventYes
get_fight
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
bout_idYesFight id (bout_id) from get_event or get_fighter_fights.

Output Schema

ParametersJSON Schema
NameRequiredDescription
boutYes
oddsYes
roundsYes
fightersYes
rounds_noteNo
get_fighter
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
fighter_idYesFighter id from search_fighters.

Output Schema

ParametersJSON Schema
NameRequiredDescription
ratingYes
recordYes
fighterYes
ufc_recordYes
career_ratesYes
recent_fightsYes
get_fighter_fights
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax fights (default 50).
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
offsetNoPage offset; use next_offset.
fighter_idYesFighter id from search_fighters.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
fightsYes
fighter_idYes
next_offsetNo
get_leaders
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
statYesWhich leaderboard.
limitNoMax fighters (default 20).
sinceNoOnly fights from this year on, e.g. 2020.
min_fightsNoMinimum fights to qualify (default 5).
weight_classNoOnly fights in this weight class, e.g. Lightweight.

Output Schema

ParametersJSON Schema
NameRequiredDescription
statYes
countYes
labelYes
leadersYes
min_fightsYes
get_line_movement
Read-only
Inspect

Use to see how a fight's line moved before the bell: our snapshots of each posted moneyline, from first capture to fight day (ESPN's once a day from October 2026, The Odds API's every hour in the two days before). Costs 10 credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
bout_idYesFight id.
providerNoOne sportsbook, e.g. DraftKings.

Output Schema

ParametersJSON Schema
NameRequiredDescription
boutYes
noteNo
movementYes
snapshotsYes
get_odds
Read-only
Inspect

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 (ESPN's own feed is one book per fight since mid-2024). Pass bout_id for one fight (5 credits) or event_id for a whole card (10 credits).

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
bout_idNoOne fight.
event_idNoA whole card.

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
toolNo
boutsNo
countNo
creditsNo
estimate_onlyNo
get_ratings
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax fighters (default 25).
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
active_sinceNoOnly fighters whose last fight was in this year or later.
weight_classNoe.g. Welterweight.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
methodYes
ratingsYes
active_sinceYes
get_schedule
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
daysNoDays ahead (default 30, max 180).
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.

Output Schema

ParametersJSON Schema
NameRequiredDescription
daysYes
boutsYes
countYes
list_events
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax events (default 50).
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
offsetNoPage offset; use next_offset.
seasonNoYear, e.g. 2025.
statusNoOnly upcoming or only completed cards.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
eventsYes
next_offsetNo
search_fighters
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax results (default 20).
queryYesName or nickname, e.g. Topuria or 'El Matador'.
leagueNoLeague. Defaults to mma. One of: mma, pfl, bellator.
weight_classNoe.g. Lightweight, Women's Strawweight.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
fightersYes

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 11 tool updates
    • First observedget_event
    • First observedget_fight
    • First observedget_fighter
    • First observedget_fighter_fights
    • First observedget_leaders
    • First observedget_line_movement
    • First observedget_odds
    • First observedget_ratings
    • First observedget_schedule
    • First observedlist_events
    • First observedsearch_fighters

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Cloudflare Worker REST API + local MCP server for China Sports Lottery football odds, providing live odds, derived probabilities, Kelly value, and parlay calculation.
    17
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Public read-only MCP server exposing today's free sports-betting projections, track record, methodology, engine versions, and per-game model reads from the Olympus Bets Analytics platform.
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Live sports betting player props MCP server covering NBA, MLB, NFL, NHL, NCAA, and soccer. Unified from real sportsbooks into one REST API and a real MCP server (Streamable HTTP). Free tier, no card required.
    5
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Props-first sports odds API with a hosted MCP server. Live odds and player props (moneyline, spreads, totals) across US sportsbooks, normalized to JSON. Tools: get_odds, get_props, get_events, get_books. API-key auth, free tier.
    MIT No Attribution
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.