com.ufcalendar/fight-api

Tools

• compare_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.

  shallow
• create_webhook_endpoint

  Register an https endpoint to receive signed webhooks (event announced, fight result, card changed, event completed). The signing secret is returned ONCE — store it before the reply is discarded. At most 3 active endpoints per account.

  shallow
• delete_webhook_endpoint

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

  shallow
• 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.

  shallow
• get_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.

  shallow
• 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.

  shallow
• get_calendar_feed_url

  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.

  shallow
• get_champions

  Every current champion across the promotions the API covers, with the division and the snapshot date the board was published.

  shallow
• get_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.

  shallow
• get_event_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.

  shallow
• get_event_changes

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

  shallow
• get_event_live

  The real-time document for an event on fight night: card statuses, the bout in the cage (phase, round, running clock, unofficial totals and per-round stats, referee, a timestamped action timeline) and the last result. Null when nothing is being streamed. UFC only; Pro plans and up. The same document is pushed over wss://live.ufcalendar.com/v1.

  shallow
• get_event_odds

  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.

  shallow
• 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.

  shallow
• get_fight

  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.

  shallow
• get_fight_odds

  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.

  shallow
• get_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.

  shallow
• get_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.

  shallow
• get_judge_scorecards

  Every official card one judge has turned in, newest first: per-round points, card totals, decision type and point deductions. Commission records only.

  shallow
• get_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.

  shallow
• get_matchmaker

  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.

  shallow
• get_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.

  shallow
• get_odds_history

  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.

  shallow
• get_org

  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.

  shallow
• get_pickem_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.

  shallow
• get_plans

  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.

  shallow
• get_power_index

  The UFCalendar Power Index board for one promotion — our own rating engine, refreshed hourly, with peak rating and fights rated.

  shallow
• get_predictions_upcoming

  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. Informational model output, not betting advice.

  shallow
• get_rankings

  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.

  shallow
• get_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.

  shallow
• get_usage

  How many requests the calling account has used this month, the plan limit, the per-minute limit and when the counter resets.

  shallow
• get_venue

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

  shallow
• get_venue_events

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

  shallow
• get_year_stats

  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.

  shallow
• 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.

  shallow
• how_to_watch

  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.

  shallow
• list_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.

  shallow
• 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. Cursor paginated.

  shallow
• list_judges

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

  shallow
• list_orgs

  List the promotions the UFCalendar Fight API covers, with per-org capability flags (stats, rounds, rankings, broadcasts, predictions, scorecards).

  shallow
• list_split_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.

  shallow
• list_webhook_endpoints

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

  shallow
• rotate_webhook_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.

  shallow
• search

  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.

  shallow
• search_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.

  shallow
• search_fighters

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

  shallow
• 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.

  shallow
• whos_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.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/93fc1b8d-01c8-48e4-9ead-134b8f601ccf/badge.svg)](https://vouch.tools/servers/93fc1b8d-01c8-48e4-9ead-134b8f601ccf)