MCP-Server
UFCalendar Fight API — MMA MCP server
com.ufcalendar/fight-api
Was dieses MCP kann
Provides MMA event, fighter, bout, rankings, broadcast, judging, live statistics, prediction, and webhook data across multiple promotions.
Funktionen
Tools
47
Tools
compare_fighters
Compare two fighters
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['a', 'b'], 'properties': {'a': {'type': 'string', 'minLength': 1, 'description': 'First fighter: slug (preferred, e.g. "islam-makhachev") or numeric id.'}, 'b': {'type': 'string', 'minLength': 1, 'description': 'Second fighter: slug or numeric id. Must differ from a.'}}}
create_webhook_endpoint
Register a webhook endpoint
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.
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'https:// endpoint that will receive the signed POSTs.'}, 'events': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Event kinds to subscribe to; omit for all of them.'}}}
delete_webhook_endpoint
Delete a webhook endpoint
Permanently remove one webhook endpoint from the calling account. Deliveries to it stop and its delivery history is dropped.
Destruktiv
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['endpoint_id'], 'properties': {'endpoint_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Endpoint id from list_webhook_endpoints. Integer or numeric string.'}}}
find_fights
Find fights
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest event date, YYYY-MM-DD.'}, 'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug, e.g. "ufc". Omit for every covered promotion.'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest event date, YYYY-MM-DD.'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Rows per page, default 10.'}, 'order': {'enum': ['newest', 'oldest'], 'type': 'string', 'description': 'newest (default) or oldest first.'}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}, 'method': {'enum': ['ko', 'sub', 'dec', 'finish', 'any'], 'type': 'string', 'description': 'ko = KO/TKO, sub = submission, dec = any decision, finish = KO/TKO or submission, any = no filter.'}, 'winner': {'type': 'string', 'description': 'Fighter slug or id — bouts this fighter won.'}, 'fighter': {'type': 'string', 'description': 'Fighter slug or id — bouts this fighter was in.'}, 'division': {'type': 'string', 'maxLength': 40, 'description': 'Division slug ("lightweight", "womens-strawweight") for an exact match, or a name fragment.'}, 'title_only': {'type': 'boolean', 'description': 'true = title bouts only.'}, 'main_events_only': {'type': 'boolean', 'description': 'true = main events only.'}}}
get_article
Get an article
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'minLength': 1, 'description': 'Article slug, from search_articles.'}, 'locale': {'enum': ['en', 'es', 'pt', 'de', 'fr', 'tr', 'ru', 'ka', 'ja', 'ko', 'pl', 'sr', 'zh'], 'type': 'string', 'description': 'Site language to serve (default en); English when no translation exists.'}}}
get_broadcast_rights
Get broadcast rights
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug.'}, 'series': {'enum': ['dwcs', 'rtufc'], 'type': 'string', 'description': 'A UFC sub-series grid instead of the org-wide deals: dwcs (Contender Series) or rtufc (Road to UFC). For one event, how_to_watch picks it for you.'}, 'country': {'type': 'string', 'description': 'ISO-3166 alpha-2 code; adds the worldwide row.'}}}
get_calendar_feed_url
Get calendar feed URLs
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 <your-api-key> placeholder where the key goes. Returns URL templates only, never the caller's credential; the human pastes the finished URL into their calendar app.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug.'}}}
get_champions
Get current champions
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug, e.g. "ufc". Omit for every covered promotion.'}, 'division': {'type': 'string', 'description': 'One division, e.g. "lightweight" or "womens-strawweight". Omit for every division.'}}}
get_division
Get a division
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org', 'division'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug.'}, 'division': {'enum': ['strawweight', 'flyweight', 'bantamweight', 'featherweight', 'lightweight', 'welterweight', 'super-welterweight', 'middleweight', 'light-heavyweight', 'heavyweight', 'super-heavyweight', 'womens-strawweight', 'womens-flyweight', 'womens-bantamweight', 'womens-featherweight', 'atomweight', 'ironweight'], 'type': 'string', 'description': 'Division slug, e.g. "lightweight", "womens-strawweight".'}}}
get_event_card
Get an event and its full card
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).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event'], 'properties': {'event': {'type': 'string', 'description': 'Event slug (preferred) or numeric id.'}, 'include': {'type': 'array', 'items': {'enum': ['eta', 'odds'], 'type': 'string'}, 'description': "eta = an estimated start time on every bout (estimates, not a schedule; re-anchored on each completed bout). odds = each bout's latest UFCalendar consensus line (information only, not betting advice)."}}}
get_event_changes
Get an event’s change log
The audit trail for one card: bouts added or cancelled, opponents swapped, start times moved, fighter profiles merged — newest first.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event'], 'properties': {'event': {'type': 'string', 'description': 'Event slug (preferred) or numeric id.'}}}
get_event_odds
Get consensus odds for a card
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. Unpriced bouts are listed with nulls. Book identities are never exposed. Information only, not betting advice.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event'], 'properties': {'event': {'type': 'string', 'description': 'Event slug (preferred) or numeric id.'}}}
get_event_storylines
Get event storylines
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event'], 'properties': {'event': {'type': 'string', 'description': 'Event slug (preferred) or numeric id.'}}}
get_fight
Get a bout
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).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fight_id'], 'properties': {'include': {'type': 'array', 'items': {'enum': ['stats', 'rounds', 'scorecards', 'odds'], 'type': 'string'}, 'description': 'Extra blocks to fetch in the same call. odds = the latest UFCalendar consensus line (information only, not betting advice).'}, 'fight_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Bout id, as returned on an event card. Integer or numeric string.'}}}
get_fighter
Get a fighter
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fighter'], 'properties': {'fighter': {'type': 'string', 'description': 'Fighter slug (preferred) or numeric id.'}, 'include': {'type': 'array', 'items': {'enum': ['history', 'stats', 'rankings', 'power_index', 'bonuses', 'credentials'], 'type': 'string'}, 'description': 'Extra blocks to fetch in the same call. bonuses = the UFC bonus ledger (FOTN/POTN/KOTN/SOTN counts and fights); credentials = grappling and wrestling pedigree, gyms and coaches, each row with its sources and a confidence grade.'}, 'history_limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Cap the career timeline at the N most recent bouts.'}}}
get_fight_odds
Get consensus odds for a bout
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. Book identities are never exposed. Information only, not betting advice.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fight_id'], 'properties': {'fight_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Bout id, as returned on an event card. Integer or numeric string.'}}}
get_judge
Get a judge
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['judge_id'], 'properties': {'judge_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Judge id, from list_judges. Integer or numeric string.'}}}
get_judge_scorecards
Get a judge’s scorecards
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['judge_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string'}, 'judge_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Judge id, from list_judges. Integer or numeric string.'}}}
get_leaderboard
Get a stat leaderboard
One statistical leaderboard for one promotion from UFCalendar's Record Book rollup — career, single-fight, single-round, division or event boards across 48 metrics (wins, finishes, significant strikes, takedowns, control time, finish rate and more), optionally narrowed to a division, a country or active fighters. Ranked, with the sample size behind each value.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org', 'metric'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug (required — boards are per promotion).'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Rows, default 25.'}, 'metric': {'enum': ['total_fights', 'wins', 'decision_wins', 'title_fight_wins', 'bonuses', 'finishes', 'win_streak', 'total_fight_seconds', 'avg_fight_seconds_short', 'avg_fight_seconds_long', 'control_time_sec', 'control_time_pct', 'sig_strikes_landed', 'total_strikes_landed', 'slpm', 'sapm', 'striking_differential', 'sig_strike_accuracy', 'sig_strike_defense', 'knockdowns', 'knockdowns_per_15', 'knockouts', 'takedowns_landed', 'td_avg', 'takedown_accuracy', 'takedown_defense', 'submission_attempts', 'sub_avg_per_15', 'submissions', 'fastest_finish', 'fastest_knockout', 'fastest_submission', 'longest_fight_seconds', 'most_sig_strikes_fight', 'most_takedowns_fight', 'most_knockdowns_fight', 'longest_control_fight', 'most_sig_strikes_round', 'most_takedowns_round', 'most_knockdowns_round', 'most_finishes_event', 'most_knockouts_event', 'shortest_card_seconds', 'finish_rate', 'ko_rate', 'sub_rate', 'decision_rate', 'avg_fight_seconds'], 'type': 'string', 'description': 'Board metric, e.g. "wins", "finishes", "sig_strikes_landed", "fastest_knockout", "most_finishes_event", "finish_rate".'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO-3166 alpha-2 nationality, e.g. "BR" — fighters from that country. Not with population=active.'}, 'division': {'enum': ['strawweight', 'flyweight', 'bantamweight', 'featherweight', 'lightweight', 'welterweight', 'super-welterweight', 'middleweight', 'light-heavyweight', 'heavyweight', 'super-heavyweight', 'womens-strawweight', 'womens-flyweight', 'womens-bantamweight', 'womens-featherweight', 'atomweight', 'ironweight'], 'type': 'string', 'description': 'One weight class, e.g. "lightweight", "womens-strawweight".'}, 'population': {'enum': ['all', 'active'], 'type': 'string', 'description': 'all (default) = everyone who fought in the promotion; active = a bout in the last ~18 months.'}}}
get_matchmaker
Get the matchmaker board
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug (MMA promotions; bkfc has no matchmaker pool).'}, 'limit': {'type': 'integer', 'maximum': 24, 'minimum': 1, 'description': 'Slips to return (default 10, max 24).'}, 'division': {'type': 'string', 'maxLength': 40, 'description': 'One division slug, e.g. "lightweight", "womens-strawweight". Omit for the cross-division board; meta.divisions lists the valid ones.'}}}
get_next_event
Get the next event
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug, e.g. "ufc". Omit for the next card across every covered promotion.'}, 'skip_series': {'type': 'boolean', 'description': "UFC only: skip Dana White's Contender Series and Road to UFC cards while a numbered card or Fight Night is booked. Default true."}, 'include_card': {'type': 'boolean', 'description': 'Also return the full bout order, venue and broadcasts (same shape as get_event_card). Default false.'}}}
get_odds_history
Get the odds line movement
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fight_id'], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest recorded day, YYYY-MM-DD (inclusive).'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest recorded day, YYYY-MM-DD (inclusive).'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Points per page, default 100.'}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}, 'fight_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Bout id, as returned on an event card. Integer or numeric string.'}}}
get_org
Get a promotion
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug.'}}}
get_pickem_splits
Get pick'em splits
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event'], 'properties': {'event': {'type': 'string', 'description': 'Event slug (preferred) or numeric id.'}}}
get_plans
Plans and quotas
List the UFCalendar Fight API plans, their monthly request quotas and per-minute limits, and the terms of the no-card trial. Answers "what does this cost" without a credential.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
get_power_index
Get the UFCalendar Power Index board
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug.'}, 'days': {'type': 'integer', 'maximum': 3650, 'minimum': 30, 'description': 'Window for view=movers, in days. Default 365. days is snapped to 30/90/180/365/730/1825/3650.'}, 'view': {'enum': ['current', 'movers', 'peaks'], 'type': 'string', 'description': 'current (default) = active fighters by rating; movers = biggest risers over `days`; peaks = all-time peak ratings reached in this promotion.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1}, 'division': {'type': 'string', 'description': 'Division slug to narrow the board, e.g. "lightweight", "light-heavyweight", "womens-strawweight".'}}}
get_predictions_upcoming
Get model win probabilities
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'event': {'type': 'string', 'description': 'Event slug or numeric id to narrow to one card. Omit for every upcoming UFC bout.'}}}
get_rankings
Get a rankings board
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug.'}, 'date': {'type': 'string', 'description': 'Read the board as it stood on this date, YYYY-MM-DD.'}, 'board': {'type': 'string', 'description': 'Board name; defaults to the official board.'}, 'division': {'type': 'string', 'description': 'One division, e.g. "lightweight". Omit for the whole board.'}}}
get_record_book
Get the record book
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['org'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug (required — the Record Book is per promotion).'}, 'top': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Rows per board. Default 3 here (the whole book at 10 rows is ~140 KB); up to 25.'}, 'scope': {'enum': ['career', 'single_fight', 'round', 'division', 'event'], 'type': 'string', 'description': 'One kind of board: career, single_fight, round, division or event. Omit for all.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO-3166 alpha-2 nationality, e.g. "BR" — fighters from that country. Not with population=active.'}, 'division': {'enum': ['strawweight', 'flyweight', 'bantamweight', 'featherweight', 'lightweight', 'welterweight', 'super-welterweight', 'middleweight', 'light-heavyweight', 'heavyweight', 'super-heavyweight', 'womens-strawweight', 'womens-flyweight', 'womens-bantamweight', 'womens-featherweight', 'atomweight', 'ironweight'], 'type': 'string', 'description': 'One weight class, e.g. "lightweight", "womens-strawweight".'}, 'population': {'enum': ['all', 'active'], 'type': 'string', 'description': 'all (default) = everyone who fought in the promotion; active = a bout in the last ~18 months.'}}}
get_usage
Get your API usage
How many requests the calling account has used this month, the plan limit, the per-minute limit and when the counter resets — and, on the free 1-day trial, when the trial ends (trial_ends_at).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
get_venue
Get a venue
Fetch one venue by id: name, city, region, country, capacity, coordinates and IANA time zone.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['venue_id'], 'properties': {'venue_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Venue id. Integer or numeric string.'}}}
get_venue_events
List events at a venue
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).
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['venue_id'], 'properties': {'to': {'type': 'string', 'description': 'Latest event date, YYYY-MM-DD.'}, 'from': {'type': 'string', 'description': 'Earliest event date, YYYY-MM-DD.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'desc = newest first (default), asc = oldest first.'}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}, 'status': {'enum': ['announced', 'scheduled', 'live', 'completed', 'cancelled', 'postponed', 'upcoming'], 'type': 'string', 'description': 'Filter by event status. upcoming = every card not yet over (announced, scheduled or live), soonest first.'}, 'venue_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Venue id, from search_venues or an event card. Integer or numeric string.'}}}
get_year_stats
Get a year in review
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['year'], 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug, e.g. "ufc". Omit for every covered promotion together.'}, 'year': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1993, 'description': 'Calendar year, 1993 to the current year.'}}}
how_to_connect
How to connect
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
how_to_watch
How to watch an event
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['event'], 'properties': {'event': {'type': 'string', 'description': 'Event slug (preferred) or numeric id.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO-3166 alpha-2 code, e.g. "US" — that market plus the worldwide row. Omit for every country.'}}}
list_changes
List recent card changes
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug, e.g. "ufc". Omit for every covered promotion.'}, 'kind': {'enum': ['fight-added', 'fight-cancelled', 'fight-reinstated', 'opponent-changed', 'time-changed', 'venue-changed', 'fighter-merged'], 'type': 'string', 'description': 'Narrow to one change kind.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'since': {'type': 'string', 'description': 'Only changes observed at or after this point: YYYY-MM-DD or an ISO-8601 datetime. Default: 90 days ago.'}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}}}
list_events
List events
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Latest event date, YYYY-MM-DD.'}, 'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug, e.g. "ufc". Omit for every covered promotion.'}, 'from': {'type': 'string', 'description': 'Earliest event date, YYYY-MM-DD.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'order': {'enum': ['asc', 'desc'], 'type': 'string', 'description': 'asc = soonest first (default for upcoming), desc = newest first.'}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}, 'is_ppv': {'type': 'boolean', 'description': 'Only pay-per-view cards (true) or non-PPV cards (false).'}, 'status': {'enum': ['announced', 'scheduled', 'live', 'completed', 'cancelled', 'postponed', 'upcoming'], 'type': 'string', 'description': 'Filter by event status. upcoming = every card not yet over (announced, scheduled or live), soonest first.'}, 'include': {'type': 'array', 'items': {'enum': ['headline'], 'type': 'string'}, 'description': "headline = each event's main event (both corners, division, title flag and the result once fought) in the same call."}, 'is_title_card': {'type': 'boolean', 'description': 'Only cards with (true) or without (false) a title bout.'}}}
list_judges
List judges
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Name fragment.'}, 'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string'}, 'min_fights': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}}
list_orgs
List promotions
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
list_split_decisions
List split and majority decisions
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Latest event date, YYYY-MM-DD.'}, 'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Promotion slug, e.g. "ufc". Omit for every covered promotion.'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Earliest event date, YYYY-MM-DD.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Rows per page, default 25.'}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}}}
list_webhook_endpoints
List webhook endpoints
List the signed webhook endpoints registered on the calling account, with the event kinds each one subscribes to.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', 'properties': {}}
rotate_webhook_secret
Rotate a webhook signing secret
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.
Destruktiv
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['endpoint_id'], 'properties': {'endpoint_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string', 'pattern': '^\\d+$'}], 'description': 'Endpoint id from list_webhook_endpoints. Integer or numeric string.'}}}
search
Search fighters and events
Typeahead search across fighters and events in one call. Use it to turn a name a user typed into a slug you can pass to the other tools.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['q'], 'properties': {'q': {'type': 'string', 'minLength': 2, 'description': 'At least 2 characters.'}}}
search_articles
Search UFCalendar articles
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'minLength': 2, 'description': 'Keyword, at least 2 characters: matches the title, summary or a tag.'}, 'tag': {'type': 'string', 'description': 'Exact tag, e.g. "ufc".'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Rows per page, default 10.'}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}, 'locale': {'enum': ['en', 'es', 'pt', 'de', 'fr', 'tr', 'ru', 'ka', 'ja', 'ko', 'pl', 'sr', 'zh'], 'type': 'string', 'description': 'Site language to serve (default en); English when no translation exists.'}}}
search_fighters
Search the roster
Search the fighter roster by name, nationality or promotion. Cursor paginated. Returns identity fields; use get_fighter for the full record.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Name or nickname fragment.'}, 'org': {'enum': ['ufc', 'pfl', 'oktagon', 'bkfc', 'rizin'], 'type': 'string', 'description': 'Only fighters who have fought for this promotion.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string'}, 'country': {'type': 'string', 'description': 'ISO-3166 alpha-2 code or country name.'}}}
search_venues
Search venues
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'minLength': 2, 'description': 'Venue name or city fragment, at least 2 characters.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string', 'description': 'meta.pagination.next_cursor from a previous call.'}, 'country': {'type': 'string', 'description': 'ISO-3166 alpha-2 code ("US") or English country name ("Brazil").'}}}
whos_next
Who should fight next
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.
Nur Lesen
Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['fighter'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Opponents to suggest (default 5, max 10).'}, 'fighter': {'type': 'string', 'minLength': 1, 'description': 'Fighter slug (preferred, e.g. "islam-makhachev") or numeric id.'}}}
Verlauf
Letzte Tool-Änderungen
Entfernt
get_event_live
28. September 2026 02:41
Entfernt
get_bulk_snapshot_url
28. September 2026 02:41
Geändert
get_venue_events
28. September 2026 02:41
Geändert
get_usage
28. September 2026 02:41
Geändert
get_champions
28. September 2026 02:41
Geändert
list_events
28. September 2026 02:41
Geändert
create_webhook_endpoint
26. September 2026 02:41
Hinzugefügt
get_bulk_snapshot_url
26. September 2026 02:41
Hinzugefügt
get_calendar_feed_url
26. September 2026 02:41
Hinzugefügt
get_article
26. September 2026 02:41
Hinzugefügt
search_articles
26. September 2026 02:41
Hinzugefügt
get_venue_events
26. September 2026 02:41
Hinzugefügt
search_venues
26. September 2026 02:41
Hinzugefügt
list_split_decisions
26. September 2026 02:41
Geändert
get_judge_scorecards
26. September 2026 02:41
Hinzugefügt
get_judge
26. September 2026 02:41
Geändert
list_judges
26. September 2026 02:41
Geändert
get_broadcast_rights
26. September 2026 02:41
Geändert
get_predictions_upcoming
26. September 2026 02:41
Hinzugefügt
get_year_stats
26. September 2026 02:41
Hinzugefügt
get_record_book
26. September 2026 02:41
Hinzugefügt
get_leaderboard
26. September 2026 02:41
Hinzugefügt
whos_next
26. September 2026 02:41
Hinzugefügt
get_matchmaker
26. September 2026 02:41
Geändert
get_power_index
26. September 2026 02:41
Geändert
get_rankings
26. September 2026 02:41
Hinzugefügt
compare_fighters
26. September 2026 02:41
Geändert
get_fighter
26. September 2026 02:41
Hinzugefügt
find_fights
26. September 2026 02:41
Geändert
get_fight
26. September 2026 02:41
Entdecken
Ähnliche MCP-Server
Mlb Stats
io.github.pipeworx-io/mlb-stats
Provides official MLB schedules, scores, standings, rosters, player statistics, game logs, matchups, probable pitchers, lineups, …
Football Data
io.github.pipeworx-io/football-data
Retrieves soccer competitions, matches, team details, standings, schedules, and competition metadata.
Openf1
io.github.pipeworx-io/openf1
Provides live and historical Formula 1 meeting, session, driver, lap, timing, and telemetry data.
Openligadb
io.github.pipeworx-io/openligadb
Provides football and soccer league listings, fixtures, match results, and standings.
Gdelt
io.github.pipeworx-io/gdelt
Provides access to GDELT global news and event data for researching events, media coverage, language, and tone.
extract
com.mart402/extract
Extracts and verifies information from webpages, PDFs, images, invoices, payslips, and company sources, with OCR, document parsin…
Mukoko News
io.github.nyuchi/mukoko-news
Searches and reads African news, provides regional briefings and source views, tracks stories, and analyzes coverage trends, cate…
PuckAPI
io.github.noahowsh/puckapi
Queries NHL schedules, games, players, teams, standings, statistics, play-by-play, shot maps, and betting odds.