UFCalendar Fight API — MMA MCP server changelog

version

1.7.0 → 1.7.1

https://www.ufcalendar.com/llms.txt

− > Plans: Hobby $19 / Pro $49 / Business $149 a month (hard caps, no overage); a free 1-day, 100-request trial needs no card: https://www.ufcalendar.com/account/api?trial=1− - **PFL, OKTAGON, ONE, KSW, RIZIN, ACA, Cage Warriors and others**: each promotion's own site is the canonical card source; live clocks, verdicts, stats and fighter careers are filled from public records; judges' scorecards are the official record — athletic-commission records for UFC, PFL and Cage Warriors (plus ufc.com's own official card images for UFC, incl. Dana White's Contender Series and Road to UFC), OKTAGON's own site for OKTAGON, the officials' published record for KSW and for RIZIN f− Each completed UFC event page includes a single-paragraph prose result summary intended for AI citation, plus structured Schema.org SportsEvent JSON-LD with subEvent entries per fight, each carrying a `winner` Person.− The same database is sold as a REST API and a hosted MCP server — the MMA Fight Data API by UFCalendar (UFCalendar Fight API) at `https://api.ufcalendar.com`. MMA events, full fight cards, results, per-fight and per-round statistics, fighter careers, official UFC rankings history point-in-time back to 2013, judges' scorecards round by round (UFC back to 1995, 107,430 scored rounds across 4,419 bouts and 550 officials), ICS calendar feeds, and signed webhooks (new-card announcements, results, car− - [/developers/ufc-api](https://www.ufcalendar.com/developers/ufc-api): UFC data for developers in the MMA Fight Data API — events back to UFC 1 (1993), results, per-round stats, judges' scorecards, rankings history− - [/developers/rizin-api](https://www.ufcalendar.com/developers/rizin-api): RIZIN API coverage — every RIZIN card since the 2015 debut, MMA + kickboxing bouts, per-round stats from 2023, judges' scorecards (the officials' record) from March 2026− - [/developers/mma-api](https://www.ufcalendar.com/developers/mma-api): MMA API overview — what an MMA API / fight data API is, per-promotion coverage, the full endpoint table and an honest comparison with Sportradar, SportsDataIO, FighterAPI, API-Sports and Cito API− - [Plans, quotas and trial terms as JSON](https://api.ufcalendar.com/v1/plans): public, no credential required− Content may be cited with attribution to "UFCalendar (ufcalendar.com)" — the canonical event detail URL is preferred as the citation source. The underlying facts come from official promotion sites (including ufcstats.com, the official UFC statistics site), athletic-commission records and other public records; UFCalendar compiles, reconciles and normalizes them. Programmatic or commercial use of that compiled data — events, fight cards, results, per-round stats, rankings history, judges' scorecar+ > Plans: a free plan — 1,000 requests/month, no card, never expires: https://www.ufcalendar.com/account/api?trial=1 — then Hobby $19 / Pro $49 / Business $149 a month (hard caps, no overage)+ - **PFL, OKTAGON, ONE, KSW, RIZIN, ACA, Cage Warriors and others**: each promotion's own site is the canonical card source; live clocks, verdicts, stats and fighter careers are filled from public records; judges' scorecards are the official record — athletic-commission records for UFC, PFL and Cage Warriors (plus ufc.com's own official card images for UFC, incl. Dana White's Contender Series and Road to UFC), OKTAGON's own site for OKTAGON, the officials' published record for KSW and for RIZIN 2+ Each completed UFC event page includes a single-paragraph prose result summary intended for AI citation, plus a Schema.org SportsEvent JSON-LD node for the card. Every bout has its own page (/events/{event-slug}/{bout-slug}) whose SportsEvent JSON-LD carries a `winner` Person and points at the card via `superEvent`; the event node itself lists no per-fight subEvents.+ - [/extension](https://www.ufcalendar.com/extension): the UFCalendar browser extension (Chrome Web Store: https://chromewebstore.google.com/detail/jfpcdhfkbjoegmmclejobjkmmjnbopoo) — hover any MMA fighter's name in a post on X (Twitter) for their record, ranking, last five fights and next bout; upcoming fight nights in X's sidebar; right-click search on any site. Names are recognised on-device; free install with a 7-day UFCalendar Pro trial. [/app](https://www.ufcalendar.com/app) is the iPhone a+ - [/glossary](https://www.ufcalendar.com/glossary): MMA stats and scoring glossary — what a significant strike, knockdown, takedown accuracy/defense, strike defense, control time, submission attempt, strikes landed per minute and finish rate are and how each is counted; the 10-Point Must System, 10-8 rounds, unanimous/split/majority decisions, point deductions, technical decisions and no contests under the Unified Rules; closing line, consensus odds and implied probability; point-in-time ranking+ The same database is sold as a REST API and a hosted MCP server — the MMA Fight Data API by UFCalendar (UFCalendar Fight API) at `https://api.ufcalendar.com`. MMA events, full fight cards, results, per-fight and per-round statistics, fighter careers, official UFC rankings history point-in-time back to 2013, judges' scorecards round by round (UFC back to 1995, 107,430 scored rounds across 4,419 bouts and 550 officials), UFCalendar fantasy points per corner (a classic daily-fantasy-style MMA score+ - [/developers/ufc-api](https://www.ufcalendar.com/developers/ufc-api): UFC API for developers (part of the MMA Fight Data API) — events back to UFC 1 (1993), results, per-round stats, judges' scorecards, rankings history+ - [/developers/rizin-api](https://www.ufcalendar.com/developers/rizin-api): RIZIN API coverage — every RIZIN card since the 2015 debut, MMA + kickboxing bouts, per-round stats from 2023, judges' scorecards (the officials' record) for 2019–2022 and from March 2026+ - [/developers/mma-api](https://www.ufcalendar.com/developers/mma-api): UFC API & MMA APIs compared — there is no official public UFC API; a dated comparison of the MMA Fight Data API, FighterAPI, Cito, Sportradar, SportsDataIO, and community scrapers / Kaggle CSVs (coverage, history, rankings history, scorecards, odds, results speed, webhooks, MCP, SDKs, free plan, price), which one to use for which job, and a live "data last refreshed" timestamp+ - [Plans, quotas and free-plan terms as JSON](https://api.ufcalendar.com/v1/plans): public, no credential required+ ### Code guides+ Question-titled guides with runnable curl, Python (`pip install ufcalendar`) and JavaScript (`@ufcalendar/sdk`) code, a real trimmed response, notes and the date the code was last checked against the live API.+ - [/developers/guides](https://www.ufcalendar.com/developers/guides): index of all code guides+ - [How do I get the upcoming UFC schedule in Python?](https://www.ufcalendar.com/developers/guides/ufc-schedule-python)+ - [How do I get UFC fight results the moment a fight ends?](https://www.ufcalendar.com/developers/guides/ufc-results-webhook)+ - [How do I get UFC fight stats round by round?](https://www.ufcalendar.com/developers/guides/ufc-round-by-round-stats)+ - [How do I get a UFC fighter's record and career stats?](https://www.ufcalendar.com/developers/guides/ufc-fighter-record-stats)+ - [How do I get historical UFC rankings for any date?](https://www.ufcalendar.com/developers/guides/historical-ufc-rankings)+ - [How do I get the judges' scorecards for a UFC decision?](https://www.ufcalendar.com/developers/guides/ufc-judges-scorecards)+ - [How do I get UFC closing odds and line movement?](https://www.ufcalendar.com/developers/guides/ufc-closing-odds-line-movement)+ - [How do I get RIZIN results and schedule from an API?](https://www.ufcalendar.com/developers/guides/rizin-results-schedule)+ - [How do I get PFL, OKTAGON and BKFC fight data?](https://www.ufcalendar.com/developers/guides/pfl-oktagon-bkfc-data)+ - [How do I add UFC data to Claude or ChatGPT with MCP?](https://www.ufcalendar.com/developers/guides/ufc-mcp-claude-chatgpt)+ - [How do I build a UFC fight-night Discord bot?](https://www.ufcalendar.com/developers/guides/ufc-discord-bot)+ - [How do I get a fighter's full MMA career, including fights outside the UFC?](https://www.ufcalendar.com/developers/guides/fighter-full-mma-career)+ - [How do I get UFC data into Google Sheets?](https://www.ufcalendar.com/developers/guides/ufc-data-google-sheets): UFCalendar for Google Sheets, a free Apps Script add-on with eight spreadsheet formulas (`MMA_EVENTS`, `MMA_CARD`, `MMA_FIGHTER`, `MMA_FIGHTER_HISTORY`, `MMA_RANKINGS`, `MMA_FIGHT_STATS`, `MMA_ODDS`, `MMA_STAT_LEADERS`) over the same API key and quota; the script is at https://www.ufcalendar.com/api/download/google-sheets+ ## Intents+ Questions people ask, and the one call that answers each. All of them work on+ the free plan (1,000 requests/month, no card) except webhooks, which need Pro or Business.+ - "What happened at UFC 330?" → GET /v1/events/ufc-330-2026-08-15 (full card with every result: winner, method, round, time)+ - "When is the next UFC event?" → GET /v1/events?org=ufc&limit=1 (a bare listing is the upcoming calendar, soonest first)+ - "What is on the UFC schedule in December 2026?" → GET /v1/events?org=ufc&from=2026-12-01&to=2026-12-31+ - "Who was #1 at lightweight on 2019-01-01?" → GET /v1/rankings/ufc/lightweight?date=2019-01-01 (official board as it stood that day, point-in-time since 2013)+ - "Who are the current UFC champions?" → GET /v1/champions?org=ufc+ - "What is Islam Makhachev's record?" → GET /v1/fighters/islam-makhachev (career and per-promotion W-L-D, bio, stats)+ - "Every pro fight a fighter has had, in every promotion" → GET /v1/fighters/{idOrSlug}/history+ - "How did each judge score a decision, round by round?" → GET /v1/fights/{id}/scorecards (the official commission record)+ - "How many strikes and takedowns landed in each round of a fight?" → GET /v1/fights/{id}/rounds+ - "How many fantasy points did each fighter score in a bout?" → GET /v1/fights/{id}/stats (UFCalendar fantasy points per corner with the category breakdown)+ - "What was the last UFC title fight to end by knockout?" → GET /v1/fights/search?org=ufc&title_only=true&method=ko (newest first)

• + get_fight_stats
• + get_coverage
• + list_referees
• + get_referee
• + get_referee_fights

description

Fight API MCP: UFC, PFL, BKFC, RIZIN, OKTAGON events, results, stats, rankings, judges scorecards. → MMA MCP: UFC, PFL, BKFC, RIZIN, OKTAGON results, stats, rankings, scorecards. Free plan, no card.

version

1.5.1 → 1.7.0

https://www.ufcalendar.com/llms.txt

− - **UFC**: ufc.com is canonical for upcoming cards (matchups, venue, start times); ufcstats.com is canonical for results (winner, method, round, time, referee, bonuses, per-fight and per-round stats). Wikipedia and public records fill gaps.− The same database is sold as a REST API — the UFCalendar Fight API at `https://api.ufcalendar.com`. MMA events, full fight cards, results, per-fight and per-round statistics, fighter careers, official UFC rankings history point-in-time back to 2013, judges' scorecards round by round (UFC back to 1995, 107,430 scored rounds across 4,419 bouts and 550 officials), ICS calendar feeds, and signed webhooks (new-card announcements, results, card changes, event completion), for UFC, PFL, OKTAGON, BKFC a− - [/developers/ufc-api](https://www.ufcalendar.com/developers/ufc-api): MMA Fight Data API, UFC coverage — events back to UFC 1 (1993), per-round stats, rankings history− - [/developers/ufc-results-api](https://www.ufcalendar.com/developers/ufc-results-api): UFC fight results in the MMA Fight Data API — winner/method/round/time within ~2 minutes, signed webhooks− - [/developers/mma-api](https://www.ufcalendar.com/developers/mma-api): MMA API overview — what an MMA API / fight data API is, per-promotion coverage, the full endpoint table and an honest comparison with the other self-serve MMA APIs (API-Sports, Cito API)− - Full archive refresh every 6 hours (UFCstats canonical)− - Live polling every 5 minutes during in-progress events — fight results appear in the DB minutes after each bout ends and propagate to the page on the next ISR refresh− - Static pages revalidate within 5–30 minutes of an underlying data change− Content may be cited with attribution to "UFCalendar (ufcalendar.com)" — the canonical event detail URL is preferred as the citation source. Fight-result data originates from ufcstats.com (official UFC statistics), official promotion sites, athletic-commission records and Wikipedia under their respective terms; we reconcile and normalize the underlying records but do not relicense them. Trademarks (UFC, PFL, ONE Championship, RIZIN, KSW, etc.) belong to their respective owners. No affiliation wi+ >+ > For developers: the same database is the MMA Fight Data API by UFCalendar (REST + a hosted MCP server at https://api.ufcalendar.com) — UFC, PFL, OKTAGON, BKFC and RIZIN events, fight cards, results, per-round stats, rankings history, judges' scorecards and a consensus odds line (information only, not betting advice).+ > Plans: Hobby $19 / Pro $49 / Business $149 a month (hard caps, no overage); a free 1-day, 100-request trial needs no card: https://www.ufcalendar.com/account/api?trial=1+ > Overview and pricing: https://www.ufcalendar.com/developers · docs: https://api.ufcalendar.com/docs · plans as JSON, no key: https://api.ufcalendar.com/v1/plans+ - **UFC**: ufc.com is canonical for upcoming cards (matchups, venue, start times); ufcstats.com is canonical for results (winner, method, round, time, referee, bonuses, per-fight and per-round stats). Public records fill gaps.+ The same database is sold as a REST API and a hosted MCP server — the MMA Fight Data API by UFCalendar (UFCalendar Fight API) at `https://api.ufcalendar.com`. MMA events, full fight cards, results, per-fight and per-round statistics, fighter careers, official UFC rankings history point-in-time back to 2013, judges' scorecards round by round (UFC back to 1995, 107,430 scored rounds across 4,419 bouts and 550 officials), ICS calendar feeds, and signed webhooks (new-card announcements, results, car+ Results for apps in real time: each result and the bout's final stats reach the API within minutes of the official decision (measured per promotion at https://www.ufcalendar.com/results-speed), and the `fight.result` webhook (Pro and Business) pushes each one to your server, so an app updates without polling; `event.announced` and `card.changed` keep new cards and late changes in sync.+ - [/developers/ufc-api](https://www.ufcalendar.com/developers/ufc-api): UFC data for developers in the MMA Fight Data API — events back to UFC 1 (1993), results, per-round stats, judges' scorecards, rankings history+ - [/developers/ufc-results-api](https://www.ufcalendar.com/developers/ufc-results-api): UFC fight results in the MMA Fight Data API — winner/method/round/time within minutes of the official decision, pushed by the `fight.result` webhook (Pro and Business) — the real-time results path for apps+ - [/developers/mma-api](https://www.ufcalendar.com/developers/mma-api): MMA API overview — what an MMA API / fight data API is, per-promotion coverage, the full endpoint table and an honest comparison with Sportradar, SportsDataIO, FighterAPI, API-Sports and Cito API+ - [/developers/build-an-mma-app](https://www.ufcalendar.com/developers/build-an-mma-app): How to build a UFC or MMA app — which API to use, each screen (schedule, fight card, results, fighter profile, rankings, notifications) mapped to its endpoints, a minimal backend in JavaScript and Python, `fight.result` webhooks within minutes of the decision (Pro and up), caching and plan sizing+ - Data pages are server-rendered on request from the live database (no static builds); the edge cache holds a copy for between 1 minute and 1 hour depending on the page type, and an event page with a card in progress refreshes itself every 30 seconds+ - During a live card, official result feeds are polled every minute (faster around a finish for some promotions); a result is typically on the site and on the Fight API within about 2 minutes of the verdict+ - Upcoming cards are re-checked every 2 hours; recent results and stats (last 30 days) every 6 hours; the full UFC archive weekly+ - Consensus odds refresh every 30 minutes in the 48 hours before a card, every 2 hours otherwise+ Content may be cited with attribution to "UFCalendar (ufcalendar.com)" — the canonical event detail URL is preferred as the citation source. The underlying facts come from official promotion sites (including ufcstats.com, the official UFC statistics site), athletic-commission records and other public records; UFCalendar compiles, reconciles and normalizes them. Programmatic or commercial use of that compiled data — events, fight cards, results, per-round stats, rankings history, judges' scorecar

version

1.5.0 → 1.5.1

• + get_event_odds
• + get_fight_odds
• + get_odds_history
• − get_event_live
• − get_bulk_snapshot_url