Skip to main content
Glama

UFCalendar Fight API — MMA MCP server

Server Details

MMA MCP: UFC, PFL, BKFC, RIZIN, OKTAGON results, stats, rankings, scorecards. Free plan, no card.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
UFCalendar/fight-api-skill
GitHub Stars
0
ChatGPT
–
Claude
–

TDQS

A3.8/5.0

Scored across 56 tools

Disambiguation4/5

Given 56 tools, the descriptions do a genuinely strong job of carving boundaries: get_event_odds (card) vs get_fight_odds (bout), list_events vs get_next_event, get_event_changes vs list_changes, get_leaderboard vs get_record_book, get_matchmaker vs whos_next are all explicitly scoped against their neighbours, and several tools announce their own primacy ("THE tool for last/first questions", "use get_fighter for the full record"). Remaining soft spots are the search family (search vs search_fighters vs search_venues vs search_articles), get_broadcast_rights vs how_to_watch, and the three position/stat tools, which require reading the description carefully to separate.

Naming Consistency4/5

The dominant pattern is perfectly consistent snake_case verb_noun: get_*, list_*, search_*, create_*, delete_*, rotate_*. A handful of outliers break it — how_to_connect, how_to_watch, whos_next, compare_fighters, find_fights — but they remain readable and no casing conventions are mixed.

Tool Count2/5

56 tools is well past the point where an agent can hold the surface in mind, and the breadth comes partly from narrow specialisation (get_judge vs list_judges vs get_judge_scorecards vs list_split_decisions; get_fight_stats vs get_fight_positions vs get_fighter_positions). The domain is legitimately wide — fighters, events, bouts, officials, venues, odds, editorial, webhooks, billing — so it is not arbitrary bloat, but many tools could be collapsed into an include/filter parameter.

Completeness4/5

Coverage of the stated domain is unusually deep: full event/fight/fighter lifecycle, odds lines and history, officials, venues, rankings, Power Index, leaderboards, editorial, coverage metadata, plans/usage, and a complete webhook CRUD set (create/list/rotate/delete). The main gaps are a webhook update tool and any endpoint for delivery history, which delete_webhook_endpoint implies exists but nothing exposes.

Available Tools

56 tools
compare_fightersCompare two fightersA
Read-onlyIdempotent
Inspect

Head-to-head in one call: both bios and career statistics, strike location and position mix, current win streaks, previous meetings, common opponents with each result, the booked bout between them if one exists, UFCalendar's model win probability for it and the Power Index ratings. The tale-of-the-tape tool.

Inputs: a (required), b (required).

create_webhook_endpointRegister a webhook endpointA
Idempotent
Inspect

Register an https endpoint to receive signed webhooks (event announced, fight result, card changed, event completed, odds moved: the UFCalendar consensus odds line on an upcoming bout moved 5+ points or the favourite flipped; information only, not betting advice). The signing secret is returned ONCE — store it before the reply is discarded. At most 3 active endpoints per account.

Inputs: url (required), events.

delete_webhook_endpointDelete a webhook endpointA
Destructive
Inspect

Permanently remove one webhook endpoint from the calling account. Deliveries to it stop and its delivery history is dropped.

Inputs: endpoint_id (required).

find_fightsFind fightsA
Read-onlyIdempotent
Inspect

THE tool for last/first/most-recent questions — search completed bouts across UFCalendar's launch promotions by title fight, finish method (ko, sub, dec, finish), division, fighter, winner, main-event only and date range, newest first by default. One call answers "the last title fight to end by knockout"; never page the schedule for it. At least one narrowing filter is required; 25 rows per page, 10 pages deep.

Inputs: to, org, from, limit, +8 more.

get_articleGet an articleA
Read-onlyIdempotent
Inspect

One UFCalendar article by slug: full body in Markdown (client widgets removed), title, summary, author, tags and publication date, in the requested language when a translation exists (English otherwise). Betting editorial is not served.

Inputs: slug (required), locale.

get_broadcast_rightsGet broadcast rightsA
Read-onlyIdempotent
Inspect

Who airs one promotion in each country: provider, kind and link. Pass a country code to narrow it to that market plus the worldwide row.

Inputs: org (required), series, country.

get_calendar_feed_urlGet calendar feed URLsA
Read-onlyIdempotent
Inspect

The three subscribable ICS calendar feed URL templates for one promotion — per event, per card section, or per bout at its estimated start — with a placeholder where the key goes. Returns URL templates only, never the caller's credential; the human pastes the finished URL into their calendar app.

Inputs: org (required).

get_championsGet current championsA
Read-onlyIdempotent
Inspect

Every current champion across the promotions the API covers, with the division and the snapshot date the board was published. Pass org (e.g. "ufc") and/or division (e.g. "lightweight") to narrow it.

Inputs: org, division.

get_coverageGet data coverageA
Read-onlyIdempotent
Inspect

What the database holds for each covered promotion, year by year: events, settled bouts and the share of them with per-fight stats, round-by-round stats, official commission scorecards and a UFCalendar consensus odds line (information only, not betting advice), plus when the latest result landed. Computed from the data, refreshed every 30 minutes.

Inputs: org.

get_divisionGet a divisionA
Read-onlyIdempotent
Inspect

One weight class in one promotion: the current rankings board when the promotion publishes one, upcoming bouts booked at that weight, the most recent results and the active roster by recency. The division-page answer in one call.

Inputs: org (required), division (required).

get_event_cardGet an event and its full cardA
Read-onlyIdempotent
Inspect

Fetch one event by slug or id with its complete bout order, both corners, venue, broadcast listings and results when the card has been fought. Pass include=eta for per-bout estimated start times and include=odds for each bout's current UFCalendar consensus odds line (information only, not betting advice).

Inputs: event (required), include.

get_event_changesGet an event’s change logA
Read-onlyIdempotent
Inspect

The audit trail for one card: bouts added or cancelled, opponents swapped, start times moved, fighter profiles merged — newest first.

Inputs: event (required).

get_event_oddsGet consensus odds for a cardA
Read-onlyIdempotent
Inspect

The UFCalendar consensus odds line for every bout on one card, in card order: the current line, the opening line, the closing line once a bout is settled, and how far the market moved since opening, each with how many sportsbooks backed it, plus every bout's prop markets (method of victory, total rounds, goes the distance). Unpriced bouts are listed with nulls. Book identities are never exposed. Information only, not betting advice.

Inputs: event (required).

get_event_storylinesGet event storylinesA
Read-onlyIdempotent
Inspect

The talking points of one card, computed from the record: title fights and title eliminators, the closest bout by UFCalendar's model, rematches and trilogy deciders, who is on a streak, who is debuting or returning from a long layoff, the ranked fighters and champions on the card, nations represented, the tallest and longest-reach fighters and the fastest career finish on the bill.

Inputs: event (required).

get_fightGet a boutA
Read-onlyIdempotent
Inspect

Fetch one bout by id. Pass include=stats for per-fight totals, include=rounds for round-by-round statistics, include=scorecards for the official judges’ cards, include=odds for the current UFCalendar consensus odds line (the closing line once the bout is settled) (information only, not betting advice).

Inputs: fight_id (required), include.

get_fighterGet a fighterA
Read-onlyIdempotent
Inspect

Fetch one fighter by slug or id: bio, record, career statistics and freely licensed portraits. Pass include=history for the full multi-promotion career timeline, include=stats, include=rankings or include=power_index, include=bonuses for the UFC bonus ledger, and include=credentials for grappling and wrestling pedigree, gyms and coaches (sourced, confidence-graded). Always carries next_fight and last_fight.

Inputs: fighter (required), include, history_limit.

get_fighter_disciplineGet a fighter's discipline recordA
Read-onlyIdempotent
Inspect

The confirmed fouls in one fighter's UFC bouts since December 2018, both the ones the fighter committed and the ones committed against them: eye pokes and low blows from the official in-fight log, plus any other foul (an illegal knee to a grounded opponent, an upkick, a headbutt, a bite, a fence grab) confirmed by the athletic commission's point deduction or by the official result. Returns the counts by kind, the points deducted, the time bouts were stopped for them, fouls per 15 minutes, and every incident with the event, opponent, round and time, the foul, the record that confirms it (log, deduction or result), the points deducted and whether the bout ended on it. A stoppage with no record behind it is never counted. A recorded foul is not a ruling on intent. Pro plans and up.

Inputs: fighter (required).

get_fighter_positionsGet a fighter's position profileA
Read-onlyIdempotent
Inspect

Where one fighter's bouts happen over their career: the share of cage time at distance, in the clinch and on the ground, and seconds in control by position (back, mount, side, half guard, guard, clinch) for the fighter and against them, over their settled bouts with tracked positions. Pro plans and up.

Inputs: fighter (required).

get_fight_oddsGet consensus odds for a boutA
Read-onlyIdempotent
Inspect

The UFCalendar consensus odds line for one bout: the current line, the opening line, the closing line once the bout is settled, and the movement since opening in implied-probability points, each point with its American and decimal price, implied and margin-removed probability and how many sportsbooks backed it. Also the prop markets: method of victory per corner (KO/TKO, submission, decision), total rounds over/under per line and whether it goes the distance. Book identities are never exposed. Information only, not betting advice.

Inputs: fight_id (required).

get_fight_positionsGet a bout's position statsA
Read-onlyIdempotent
Inspect

Where one settled UFC bout was fought and who held control (tracked reliably from 2007): seconds standing, at distance, in the clinch and on the ground, each fighter's control time by position (clinch, back, mount, side, half guard, guard), and strikes landed and attempted by position and target, for the whole bout and per round. null means not tracked for that bout, 0 is a real zero. Settled bouts only. Pro plans and up.

Inputs: fight_id (required).

get_fight_statsGet a bout's stats and fantasy pointsA
Read-onlyIdempotent
Inspect

Per-fight totals for both corners of one bout (strikes by target and position, takedowns, knockdowns, control and position time), each with UFCalendar fantasy points and their category breakdown, plus data-quality flags in meta.quality (rounds present, position data present, whether the round sums match the totals).

Inputs: fight_id (required).

get_fight_timelineGet a bout's in-fight logA
Read-onlyIdempotent
Inspect

The official in-fight log of one settled UFC bout (June 2013 onward): every logged action in order (round starts and ends, takedowns and attempts, knockdowns, submission attempts, reversals), the referee stoppages paired with their reason (eye poke, low blow, doctor check or other) and real length, and every confirmed foul of the bout. The log labels only eye pokes and low blows, so any other foul (an illegal knee to a grounded opponent, an upkick, a headbutt, a bite, a fence grab) is reported when the athletic commission's point deduction or the official result confirms it: each stoppage says whether it was a foul, which foul, which record confirms it (log, deduction or result), who committed it, the points deducted and whether the bout ended on it; a stoppage logged as "other" with no record behind it is never a foul. Stoppage reasons are logged from December 2018. A recorded foul is not a ruling on intent. Settled bouts only. Pro plans and up.

Inputs: fight_id (required).

get_judgeGet a judgeA
Read-onlyIdempotent
Inspect

One official's career aggregates by id: fights and rounds scored, rounds scored 10-8 or wider, three-judge cards that came back split, lone dissents, first and last date scored, and the promotions worked. Same shape as a list_judges row; use get_judge_scorecards for the cards themselves.

Inputs: judge_id (required).

get_judge_scorecardsGet a judge’s scorecardsA
Read-onlyIdempotent
Inspect

Every official card one judge has turned in, newest first: per-round points, card totals, decision type and point deductions. Each row flags lone dissents and split panels and shows the colleagues' totals. Commission records only.

Inputs: judge_id (required), limit, cursor.

get_leaderboardGet a stat leaderboardA
Read-onlyIdempotent
Inspect

One statistical leaderboard for one promotion from UFCalendar's Record Book rollup — career, single-fight, single-round, division or event boards across 57 metrics (wins, finishes, significant strikes, takedowns, control time, finish rate and more; the 9 discipline boards on fouls and stoppages need a Pro plan), optionally narrowed to a division, a country or active fighters. Ranked, with the sample size behind each value.

Inputs: org (required), metric (required), limit, country, +2 more.

get_matchmakerGet the matchmaker boardA
Read-onlyIdempotent
Inspect

UFCalendar's matchmaker: the fights worth making in one promotion, scored for rank proximity, momentum, competitiveness and story (rematches, eliminators), per division or across the roster. Our own engine over rankings, Power Index and recent form — not a list of booked bouts. Runs without the website's style-clash (Fight DNA) factor, so scores can differ slightly from ufcalendar.com.

Inputs: org (required), limit, division.

get_next_eventGet the next eventA
Read-onlyIdempotent
Inspect

The single next upcoming card for one promotion, or across all of them: the soonest event that has not finished. For UFC, developmental sub-series cards (Dana White's Contender Series, Road to UFC) are skipped while a numbered card or Fight Night is booked; pass skip_series=false to include them. Pass include_card=true to get the full bout list in the same metered call.

Inputs: org, skip_series, include_card.

get_odds_historyGet the odds line movementA
Read-onlyIdempotent
Inspect

Every UFCalendar consensus odds point recorded for one bout, oldest first: the line-movement series, with how many sportsbooks backed each point. A point is stored only when the line moves. Narrow with from/to dates; cursor paginated. Pro plans and up. Information only, not betting advice.

Inputs: fight_id (required), to, from, limit, +1 more.

get_orgGet a promotionA
Read-onlyIdempotent
Inspect

Fetch one promotion by slug (ufc, pfl, oktagon, bkfc or rizin): name, short name, country, website and its capability flags (stats, rounds, rankings, broadcasts, predictions, scorecards, odds; odds are information only, not betting advice). list_orgs returns the same rows for every promotion without a credential.

Inputs: org (required).

get_pickem_splitsGet pick'em splitsA
Read-onlyIdempotent
Inspect

How the UFCalendar community is picking each bout on one card: picks for each corner, the total and the percentage, in card order. Crowd sentiment from our own pick'em game, not a market and not a forecast.

Inputs: event (required).

get_plansPlans and quotasA
Read-onlyIdempotent
Inspect

List the UFCalendar Fight API plans, their monthly request quotas and per-minute limits, including the free plan (100 requests a month, no card). Answers "what does this cost" without a credential.

Inputs: no named parameters.

get_power_indexGet the UFCalendar Power Index boardA
Read-onlyIdempotent
Inspect

The UFCalendar Power Index board for one promotion — our own rating engine, refreshed hourly, with peak rating and fights rated. Pass view=movers for the biggest risers over a window, view=peaks for all-time peak ratings, division= to narrow.

Inputs: org (required), days, view, limit, +1 more.

get_predictions_upcomingGet model win probabilitiesA
Read-onlyIdempotent
Inspect

UFCalendar model win probabilities for upcoming UFC bouts, published about three weeks out and repriced at least weekly. Corner-stamped, so a probability is never shown against the wrong pair. Pass event= to narrow to one card. Informational model output, not betting advice.

Inputs: event.

get_rankingsGet a rankings boardA
Read-onlyIdempotent
Inspect

The official rankings board for one promotion, point-in-time: pass a date to read the board as it stood that day. Rank 0 is the champion. Pass a division to narrow it. Each entry comes with movement against the previous snapshot (is_new for a debut), and meta names the previous and next snapshot dates.

Inputs: org (required), date, board, division.

get_record_bookGet the record bookA
Read-onlyIdempotent
Inspect

The Record Book for one promotion in one call: the top rows of every leaderboard, grouped by category — the all-time and single-night records an agent quotes. Narrow by division, country, active fighters or one scope.

Inputs: org (required), top, scope, country, +2 more.

get_refereeGet a refereeA
Read-onlyIdempotent
Inspect

One referee's career aggregates by slug (e.g. herb-dean): bouts worked per promotion, first and last bout, finish rate, method breakdown and average fight time. Same shape as a list_referees row; use get_referee_fights for the bouts themselves.

Inputs: referee (required).

get_referee_fightsGet the bouts a referee workedA
Read-onlyIdempotent
Inspect

Every settled bout one referee worked in the covered promotions, newest first, with both corners, the result and the event. Cursor paginated.

Inputs: referee (required), limit, cursor.

get_usageGet your API usageA
Read-onlyIdempotent
Inspect

How many requests the calling account has used this month, the plan limit, the per-minute limit and when the counter resets — and, on an owner-granted trial, when the trial ends (trial_ends_at).

Inputs: no named parameters.

get_venueGet a venueA
Read-onlyIdempotent
Inspect

Fetch one venue by id: name, city, region, country, capacity, coordinates and IANA time zone.

Inputs: venue_id (required).

get_venue_eventsList events at a venueA
Read-onlyIdempotent
Inspect

Every covered event held at one venue, newest first — upcoming cards on top, then the history. Same filters and row shape as list_events (status, from, to, order, cursor).

Inputs: venue_id (required), to, from, limit, +3 more.

get_year_statsGet a year in reviewA
Read-onlyIdempotent
Inspect

One calendar year of a promotion (or all covered promotions) in numbers: events and title fights, finish methods and busiest divisions, the fastest finishes, the biggest upsets and Power Index climbers, the busiest fighters, host countries and the most-used judges.

Inputs: year (required), org.

how_to_connectHow to connectA
Read-onlyIdempotent
Inspect

Explain how to authenticate against the UFCalendar Fight API from this MCP server: an API key bearer token, or signing in with a UFCalendar account. Returns the URLs to do it.

Inputs: no named parameters.

how_to_watchHow to watch an eventA
Read-onlyIdempotent
Inspect

Who airs one event, country by country: the promotion's rights deals merged with the event's own confirmed broadcast listings, with provider, kind (tv, stream, ppv…), link and a worldwide row. Pass a two-letter country code to get that market plus worldwide. Series-aware, so a Contender Series card shows its own deal, not the numbered-card one.

Inputs: event (required), country.

list_changesList recent card changesA
Read-onlyIdempotent
Inspect

The cross-event change feed, newest first: bouts added, cancelled or reinstated, opponents swapped, start times or venues moved, fighter profiles merged — across every covered promotion or one of them, since a date (default the last 90 days). The same audit trail webhooks deliver, for agents that poll instead.

Inputs: org, kind, limit, since, +1 more.

list_eventsList eventsA
Read-onlyIdempotent
Inspect

List fight cards by promotion, status and date range. A bare call returns the upcoming schedule, soonest first; pass order=desc for the archive, newest first. Filter to title cards or PPVs with is_title_card / is_ppv, and pass include=headline for each card's main event (and its result once fought) in the same call. Cursor paginated.

Inputs: to, org, from, limit, +6 more.

list_judgesList judgesA
Read-onlyIdempotent
Inspect

The judge directory with career aggregates: cards turned in, rounds scored, 10-8s, split cards and lone dissents, plus the league-wide baseline rates in meta.league. Filter by name, promotion or a minimum number of fights.

Inputs: q, org, limit, cursor, +1 more.

list_orgsList promotionsA
Read-onlyIdempotent
Inspect

List the promotions the UFCalendar Fight API covers, with per-org capability flags (stats, rounds, rankings, broadcasts, predictions, scorecards, odds). Odds are the UFCalendar consensus line: information only, not betting advice.

Inputs: no named parameters.

list_refereesList refereesA
Read-onlyIdempotent
Inspect

The referee directory across the covered promotions, busiest first: bouts worked, promotions, first and last bout, finish rate, how their bouts ended (KO/TKO, submission, decision, other) and average fight time. Filter by name or promotion. The referee id is a slug of the name.

Inputs: q, org, limit, cursor.

list_split_decisionsList split and majority decisionsA
Read-onlyIdempotent
Inspect

Completed bouts decided on split or majority cards, newest first, with every judge's official card and the dissenting judge named — commission records only, across covered promotions or one of them, in a date range. Facts as filed; UFCalendar adds no verdict of its own.

Inputs: to, org, from, limit, +1 more.

list_webhook_endpointsList webhook endpointsA
Read-onlyIdempotent
Inspect

List the signed webhook endpoints registered on the calling account, with the event kinds each one subscribes to.

Inputs: no named parameters.

rotate_webhook_secretRotate a webhook signing secretA
Destructive
Inspect

Replace the signing secret of one webhook endpoint. The old secret stops verifying immediately, so update the receiver first. The new secret is returned once.

Inputs: endpoint_id (required).

search_articlesSearch UFCalendar articlesA
Read-onlyIdempotent
Inspect

Search UFCalendar's own editorial archive — previews, recaps, investigations, fighter-pay and technique pieces — by keyword or tag, newest first, in any of the 13 site languages. Returns title, summary, tags, date and the canonical URL; pass the slug to get_article for the body. Betting editorial is not served.

Inputs: q, tag, limit, cursor, +1 more.

search_fightersSearch the rosterA
Read-onlyIdempotent
Inspect

Search the fighter roster by name, nationality or promotion. Cursor paginated. Returns identity fields; use get_fighter for the full record.

Inputs: q, org, limit, cursor, +1 more.

search_venuesSearch venuesA
Read-onlyIdempotent
Inspect

Find arenas and venues that have hosted a covered promotion, by name, city or country. Returns id, name, city, region, country, time zone and capacity; pass the id to get_venue_events for what was fought there.

Inputs: q, limit, cursor, country.

whos_nextWho should fight nextA
Read-onlyIdempotent
Inspect

For one fighter: the most sensible next opponents by UFCalendar's matchmaker, with the model win probability for each pairing and the score behind it, plus the bout already booked if there is one. Runs without the website's style-clash (Fight DNA) factor, so scores can differ slightly from ufcalendar.com.

Inputs: fighter (required), limit.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to query UFC, PFL, and Bellator fight results, fighter profiles, round-by-round statistics, ratings, and sportsbook moneylines through a remote MCP server and REST API.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an agent to query MMA data—fight schedules, results, per-round stats, rankings history, judges' scorecards, and consensus odds—across UFC and other promotions directly via Model Context Protocol.
      365 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Gives AI clients free, keyless access to professional boxing data — upcoming cards, recent results, boxer profiles, division rankings, broadcasters, odds and win forecasts — so they can answer fight-night questions and cite a source page. Ships tools, resources and prompts covering schedules, bouts, rankings and search.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP.
      220 npm
      2
      Apache 2.0
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.