UFCalendar Fight API — MMA MCP server

Official47 tools

by UFCalendar

Fight API MCP: UFC, PFL, BKFC, RIZIN, OKTAGON events, results, stats, rankings, judges scorecards.

com.ufcalendar/fight-api (MCP) Server

The MCP server com.ufcalendar/fight-api provides access to MMA fight data spanning UFC, PFL, OKTAGON, BKFC, and RIZIN. It covers event listings and related results, along with fight statistics, rankings, and judges scorecards.

🛠️ Key Features

MMA fight data across UFC, PFL, OKTAGON, BKFC, and RIZIN
Event information, results, and fight statistics
Rankings and judges scorecards

🚀 Use Cases

Query and display MMA event schedules and outcomes
Retrieve detailed fight stats for analysis or reporting
Show rankings and judges scorecards for specific events or bouts

⚡ Developer Benefits

Structured coverage of events, results, stats, rankings, and scorecards
Domain-focused dataset focused on MMA organizations

⚠️ Limitations

Scope is limited to MMA fight data for the listed organizations (UFC, PFL, OKTAGON, BKFC, RIZIN) based on the provided description.

Topics

agent-skillclaude-codecursorfight-apimcpmcp-servermmamma-apiskillsufcufc-api

Captured live from the server via tools/list.

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

list_orgs

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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.

Parameters1

org

string

required

Promotion slug.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug."
    }
  },
  "required": [
    "org"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

org	string	required	Promotion slug.
division	string	required	Division slug, e.g. "lightweight", "womens-strawweight".

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug."
    },
    "division": {
      "type": "string",
      "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"
      ],
      "description": "Division slug, e.g. \"lightweight\", \"womens-strawweight\"."
    }
  },
  "required": [
    "org",
    "division"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters10

org	string	optional	Promotion slug, e.g. "ufc". Omit for every covered promotion.
status	string	optional	Filter by event status. upcoming = every card not yet over (announced, scheduled or live), soonest first.
from	string	optional	Earliest event date, YYYY-MM-DD.
to	string	optional	Latest event date, YYYY-MM-DD.
order	string	optional	asc = soonest first (default for upcoming), desc = newest first.
is_title_card	boolean	optional	Only cards with (true) or without (false) a title bout.
is_ppv	boolean	optional	Only pay-per-view cards (true) or non-PPV cards (false).
include	array	optional	headline = each event's main event (both corners, division, title flag and the result once fought) in the same call.
limit	integer	optional
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "description": "Promotion slug, e.g. \"ufc\". Omit for every covered promotion.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "status": {
      "description": "Filter by event status. upcoming = every card not yet over (announced, scheduled or live), soonest first.",
      "type": "string",
      "enum": [
        "announced",
        "scheduled",
        "live",
        "completed",
        "cancelled",
        "postponed",
        "upcoming"
      ]
    },
    "from": {
      "description": "Earliest event date, YYYY-MM-DD.",
      "type": "string"
    },
    "to": {
      "description": "Latest event date, YYYY-MM-DD.",
      "type": "string"
    },
    "order": {
      "description": "asc = soonest first (default for upcoming), desc = newest first.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "is_title_card": {
      "description": "Only cards with (true) or without (false) a title bout.",
      "type": "boolean"
    },
    "is_ppv": {
      "description": "Only pay-per-view cards (true) or non-PPV cards (false).",
      "type": "boolean"
    },
    "include": {
      "description": "headline = each event's main event (both corners, division, title flag and the result once fought) in the same call.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "headline"
        ]
      }
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

org	string	optional	Promotion slug, e.g. "ufc". Omit for the next card across every covered promotion.
skip_series	boolean	optional	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	boolean	optional	Also return the full bout order, venue and broadcasts (same shape as get_event_card). Default false.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "description": "Promotion slug, e.g. \"ufc\". Omit for the next card across every covered promotion.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "skip_series": {
      "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.",
      "type": "boolean"
    },
    "include_card": {
      "description": "Also return the full bout order, venue and broadcasts (same shape as get_event_card). Default false.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters2

event	string	required	Event slug (preferred) or numeric id.
include	array	optional	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).

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "description": "Event slug (preferred) or numeric id."
    },
    "include": {
      "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).",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "eta",
          "odds"
        ]
      }
    }
  },
  "required": [
    "event"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_event_changes

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

Parameters1

event

string

required

Event slug (preferred) or numeric id.

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "description": "Event slug (preferred) or numeric id."
    }
  },
  "required": [
    "event"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

org	string	optional	Promotion slug, e.g. "ufc". Omit for every covered promotion.
since	string	optional	Only changes observed at or after this point: YYYY-MM-DD or an ISO-8601 datetime. Default: 90 days ago.
kind	string	optional	Narrow to one change kind.
limit	integer	optional
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "description": "Promotion slug, e.g. \"ufc\". Omit for every covered promotion.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "since": {
      "description": "Only changes observed at or after this point: YYYY-MM-DD or an ISO-8601 datetime. Default: 90 days ago.",
      "type": "string"
    },
    "kind": {
      "description": "Narrow to one change kind.",
      "type": "string",
      "enum": [
        "fight-added",
        "fight-cancelled",
        "fight-reinstated",
        "opponent-changed",
        "time-changed",
        "venue-changed",
        "fighter-merged"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

event	string	required	Event slug (preferred) or numeric id.
country	string	optional	ISO-3166 alpha-2 code, e.g. "US" — that market plus the worldwide row. Omit for every country.

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "description": "Event slug (preferred) or numeric id."
    },
    "country": {
      "description": "ISO-3166 alpha-2 code, e.g. \"US\" — that market plus the worldwide row. Omit for every country.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "required": [
    "event"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

event

string

required

Event slug (preferred) or numeric id.

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "description": "Event slug (preferred) or numeric id."
    }
  },
  "required": [
    "event"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

event

string

required

Event slug (preferred) or numeric id.

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "description": "Event slug (preferred) or numeric id."
    }
  },
  "required": [
    "event"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

event

string

required

Event slug (preferred) or numeric id.

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "description": "Event slug (preferred) or numeric id."
    }
  },
  "required": [
    "event"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

fight_id

any

required

Bout id, as returned on an event card. Integer or numeric string.

Raw schema

{
  "type": "object",
  "properties": {
    "fight_id": {
      "description": "Bout id, as returned on an event card. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    }
  },
  "required": [
    "fight_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

fight_id	any	required	Bout id, as returned on an event card. Integer or numeric string.
from	string	optional	Earliest recorded day, YYYY-MM-DD (inclusive).
to	string	optional	Latest recorded day, YYYY-MM-DD (inclusive).
limit	integer	optional	Points per page, default 100.
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "fight_id": {
      "description": "Bout id, as returned on an event card. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    },
    "from": {
      "description": "Earliest recorded day, YYYY-MM-DD (inclusive).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Latest recorded day, YYYY-MM-DD (inclusive).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "limit": {
      "description": "Points per page, default 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "required": [
    "fight_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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, include=odds for the current UFCalendar consensus odds line (the closing line once the bout is settled) (information only, not betting advice).

Parameters2

fight_id	any	required	Bout id, as returned on an event card. Integer or numeric string.
include	array	optional	Extra blocks to fetch in the same call. odds = the latest UFCalendar consensus line (information only, not betting advice).

Raw schema

{
  "type": "object",
  "properties": {
    "fight_id": {
      "description": "Bout id, as returned on an event card. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    },
    "include": {
      "description": "Extra blocks to fetch in the same call. odds = the latest UFCalendar consensus line (information only, not betting advice).",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "stats",
          "rounds",
          "scorecards",
          "odds"
        ]
      }
    }
  },
  "required": [
    "fight_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters12

org	string	optional	Promotion slug, e.g. "ufc". Omit for every covered promotion.
title_only	boolean	optional	true = title bouts only.
method	string	optional	ko = KO/TKO, sub = submission, dec = any decision, finish = KO/TKO or submission, any = no filter.
division	string	optional	Division slug ("lightweight", "womens-strawweight") for an exact match, or a name fragment.
fighter	string	optional	Fighter slug or id — bouts this fighter was in.
winner	string	optional	Fighter slug or id — bouts this fighter won.
from	string	optional	Earliest event date, YYYY-MM-DD.
to	string	optional	Latest event date, YYYY-MM-DD.
main_events_only	boolean	optional	true = main events only.
order	string	optional	newest (default) or oldest first.
limit	integer	optional	Rows per page, default 10.
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "description": "Promotion slug, e.g. \"ufc\". Omit for every covered promotion.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "title_only": {
      "description": "true = title bouts only.",
      "type": "boolean"
    },
    "method": {
      "description": "ko = KO/TKO, sub = submission, dec = any decision, finish = KO/TKO or submission, any = no filter.",
      "type": "string",
      "enum": [
        "ko",
        "sub",
        "dec",
        "finish",
        "any"
      ]
    },
    "division": {
      "description": "Division slug (\"lightweight\", \"womens-strawweight\") for an exact match, or a name fragment.",
      "type": "string",
      "maxLength": 40
    },
    "fighter": {
      "description": "Fighter slug or id — bouts this fighter was in.",
      "type": "string"
    },
    "winner": {
      "description": "Fighter slug or id — bouts this fighter won.",
      "type": "string"
    },
    "from": {
      "description": "Earliest event date, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Latest event date, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "main_events_only": {
      "description": "true = main events only.",
      "type": "boolean"
    },
    "order": {
      "description": "newest (default) or oldest first.",
      "type": "string",
      "enum": [
        "newest",
        "oldest"
      ]
    },
    "limit": {
      "description": "Rows per page, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

string

required

At least 2 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 2,
      "description": "At least 2 characters."
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_fighters

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

Parameters5

q	string	optional	Name or nickname fragment.
country	string	optional	ISO-3166 alpha-2 code or country name.
org	string	optional	Only fighters who have fought for this promotion.
limit	integer	optional
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Name or nickname fragment.",
      "type": "string"
    },
    "country": {
      "description": "ISO-3166 alpha-2 code or country name.",
      "type": "string"
    },
    "org": {
      "description": "Only fighters who have fought for this promotion.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters3

fighter	string	required	Fighter slug (preferred) or numeric id.
include	array	optional	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	integer	optional	Cap the career timeline at the N most recent bouts.

Raw schema

{
  "type": "object",
  "properties": {
    "fighter": {
      "type": "string",
      "description": "Fighter slug (preferred) or numeric id."
    },
    "include": {
      "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.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "history",
          "stats",
          "rankings",
          "power_index",
          "bonuses",
          "credentials"
        ]
      }
    },
    "history_limit": {
      "description": "Cap the career timeline at the N most recent bouts.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "fighter"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

a	string	required	First fighter: slug (preferred, e.g. "islam-makhachev") or numeric id.
b	string	required	Second fighter: slug or numeric id. Must differ from a.

Raw schema

{
  "type": "object",
  "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."
    }
  },
  "required": [
    "a",
    "b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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. Each entry comes with movement against the previous snapshot (is_new for a debut), and meta names the previous and next snapshot dates.

Parameters4

org	string	required	Promotion slug.
division	string	optional	One division, e.g. "lightweight". Omit for the whole board.
date	string	optional	Read the board as it stood on this date, YYYY-MM-DD.
board	string	optional	Board name; defaults to the official board.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug."
    },
    "division": {
      "description": "One division, e.g. \"lightweight\". Omit for the whole board.",
      "type": "string"
    },
    "date": {
      "description": "Read the board as it stood on this date, YYYY-MM-DD.",
      "type": "string"
    },
    "board": {
      "description": "Board name; defaults to the official board.",
      "type": "string"
    }
  },
  "required": [
    "org"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters2

org	string	optional	Promotion slug, e.g. "ufc". Omit for every covered promotion.
division	string	optional	One division, e.g. "lightweight" or "womens-strawweight". Omit for every division.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "description": "Promotion slug, e.g. \"ufc\". Omit for every covered promotion.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "division": {
      "description": "One division, e.g. \"lightweight\" or \"womens-strawweight\". Omit for every division.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_power_index

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.

Parameters5

org	string	required	Promotion slug.
view	string	optional	current (default) = active fighters by rating; movers = biggest risers over `days`; peaks = all-time peak ratings reached in this promotion.
division	string	optional	Division slug to narrow the board, e.g. "lightweight", "light-heavyweight", "womens-strawweight".
days	integer	optional	Window for view=movers, in days. Default 365. days is snapped to 30/90/180/365/730/1825/3650.
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug."
    },
    "view": {
      "description": "current (default) = active fighters by rating; movers = biggest risers over `days`; peaks = all-time peak ratings reached in this promotion.",
      "type": "string",
      "enum": [
        "current",
        "movers",
        "peaks"
      ]
    },
    "division": {
      "description": "Division slug to narrow the board, e.g. \"lightweight\", \"light-heavyweight\", \"womens-strawweight\".",
      "type": "string"
    },
    "days": {
      "description": "Window for view=movers, in days. Default 365. days is snapped to 30/90/180/365/730/1825/3650.",
      "type": "integer",
      "minimum": 30,
      "maximum": 3650
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "required": [
    "org"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

org	string	required	Promotion slug (MMA promotions; bkfc has no matchmaker pool).
division	string	optional	One division slug, e.g. "lightweight", "womens-strawweight". Omit for the cross-division board; meta.divisions lists the valid ones.
limit	integer	optional	Slips to return (default 10, max 24).

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug (MMA promotions; bkfc has no matchmaker pool)."
    },
    "division": {
      "description": "One division slug, e.g. \"lightweight\", \"womens-strawweight\". Omit for the cross-division board; meta.divisions lists the valid ones.",
      "type": "string",
      "maxLength": 40
    },
    "limit": {
      "description": "Slips to return (default 10, max 24).",
      "type": "integer",
      "minimum": 1,
      "maximum": 24
    }
  },
  "required": [
    "org"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

fighter	string	required	Fighter slug (preferred, e.g. "islam-makhachev") or numeric id.
limit	integer	optional	Opponents to suggest (default 5, max 10).

Raw schema

{
  "type": "object",
  "properties": {
    "fighter": {
      "type": "string",
      "minLength": 1,
      "description": "Fighter slug (preferred, e.g. \"islam-makhachev\") or numeric id."
    },
    "limit": {
      "description": "Opponents to suggest (default 5, max 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 10
    }
  },
  "required": [
    "fighter"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters6

org	string	required	Promotion slug (required — boards are per promotion).
metric	string	required	Board metric, e.g. "wins", "finishes", "sig_strikes_landed", "fastest_knockout", "most_finishes_event", "finish_rate".
division	string	optional	One weight class, e.g. "lightweight", "womens-strawweight".
country	string	optional	ISO-3166 alpha-2 nationality, e.g. "BR" — fighters from that country. Not with population=active.
population	string	optional	all (default) = everyone who fought in the promotion; active = a bout in the last ~18 months.
limit	integer	optional	Rows, default 25.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug (required — boards are per promotion)."
    },
    "metric": {
      "type": "string",
      "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"
      ],
      "description": "Board metric, e.g. \"wins\", \"finishes\", \"sig_strikes_landed\", \"fastest_knockout\", \"most_finishes_event\", \"finish_rate\"."
    },
    "division": {
      "description": "One weight class, e.g. \"lightweight\", \"womens-strawweight\".",
      "type": "string",
      "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"
      ]
    },
    "country": {
      "description": "ISO-3166 alpha-2 nationality, e.g. \"BR\" — fighters from that country. Not with population=active.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "population": {
      "description": "all (default) = everyone who fought in the promotion; active = a bout in the last ~18 months.",
      "type": "string",
      "enum": [
        "all",
        "active"
      ]
    },
    "limit": {
      "description": "Rows, default 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "org",
    "metric"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters6

org	string	required	Promotion slug (required — the Record Book is per promotion).
division	string	optional	One weight class, e.g. "lightweight", "womens-strawweight".
country	string	optional	ISO-3166 alpha-2 nationality, e.g. "BR" — fighters from that country. Not with population=active.
population	string	optional	all (default) = everyone who fought in the promotion; active = a bout in the last ~18 months.
scope	string	optional	One kind of board: career, single_fight, round, division or event. Omit for all.
top	integer	optional	Rows per board. Default 3 here (the whole book at 10 rows is ~140 KB); up to 25.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug (required — the Record Book is per promotion)."
    },
    "division": {
      "description": "One weight class, e.g. \"lightweight\", \"womens-strawweight\".",
      "type": "string",
      "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"
      ]
    },
    "country": {
      "description": "ISO-3166 alpha-2 nationality, e.g. \"BR\" — fighters from that country. Not with population=active.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    },
    "population": {
      "description": "all (default) = everyone who fought in the promotion; active = a bout in the last ~18 months.",
      "type": "string",
      "enum": [
        "all",
        "active"
      ]
    },
    "scope": {
      "description": "One kind of board: career, single_fight, round, division or event. Omit for all.",
      "type": "string",
      "enum": [
        "career",
        "single_fight",
        "round",
        "division",
        "event"
      ]
    },
    "top": {
      "description": "Rows per board. Default 3 here (the whole book at 10 rows is ~140 KB); up to 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "org"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

year	integer	required	Calendar year, 1993 to the current year.
org	string	optional	Promotion slug, e.g. "ufc". Omit for every covered promotion together.

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1993,
      "maximum": 9007199254740991,
      "description": "Calendar year, 1993 to the current year."
    },
    "org": {
      "description": "Promotion slug, e.g. \"ufc\". Omit for every covered promotion together.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    }
  },
  "required": [
    "year"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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. Pass event= to narrow to one card. Informational model output, not betting advice.

Parameters1

event

string

optional

Event slug or numeric id to narrow to one card. Omit for every upcoming UFC bout.

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "description": "Event slug or numeric id to narrow to one card. Omit for every upcoming UFC bout.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

org	string	required	Promotion slug.
country	string	optional	ISO-3166 alpha-2 code; adds the worldwide row.
series	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug."
    },
    "country": {
      "description": "ISO-3166 alpha-2 code; adds the worldwide row.",
      "type": "string"
    },
    "series": {
      "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.",
      "type": "string",
      "enum": [
        "dwcs",
        "rtufc"
      ]
    }
  },
  "required": [
    "org"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

q	string	optional	Name fragment.
org	string	optional
min_fights	integer	optional
limit	integer	optional
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Name fragment.",
      "type": "string"
    },
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "min_fights": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

judge_id

any

required

Judge id, from list_judges. Integer or numeric string.

Raw schema

{
  "type": "object",
  "properties": {
    "judge_id": {
      "description": "Judge id, from list_judges. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    }
  },
  "required": [
    "judge_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters3

judge_id	any	required	Judge id, from list_judges. Integer or numeric string.
limit	integer	optional
cursor	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "judge_id": {
      "description": "Judge id, from list_judges. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "string"
    }
  },
  "required": [
    "judge_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

org	string	optional	Promotion slug, e.g. "ufc". Omit for every covered promotion.
from	string	optional	Earliest event date, YYYY-MM-DD.
to	string	optional	Latest event date, YYYY-MM-DD.
limit	integer	optional	Rows per page, default 25.
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "description": "Promotion slug, e.g. \"ufc\". Omit for every covered promotion.",
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ]
    },
    "from": {
      "description": "Earliest event date, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "Latest event date, YYYY-MM-DD.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "limit": {
      "description": "Rows per page, default 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_venue

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

Parameters1

venue_id

any

required

Venue id. Integer or numeric string.

Raw schema

{
  "type": "object",
  "properties": {
    "venue_id": {
      "description": "Venue id. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    }
  },
  "required": [
    "venue_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters4

q	string	optional	Venue name or city fragment, at least 2 characters.
country	string	optional	ISO-3166 alpha-2 code ("US") or English country name ("Brazil").
limit	integer	optional
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Venue name or city fragment, at least 2 characters.",
      "type": "string",
      "minLength": 2
    },
    "country": {
      "description": "ISO-3166 alpha-2 code (\"US\") or English country name (\"Brazil\").",
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

Parameters7

venue_id	any	required	Venue id, from search_venues or an event card. Integer or numeric string.
status	string	optional	Filter by event status. upcoming = every card not yet over (announced, scheduled or live), soonest first.
from	string	optional	Earliest event date, YYYY-MM-DD.
to	string	optional	Latest event date, YYYY-MM-DD.
order	string	optional	desc = newest first (default), asc = oldest first.
limit	integer	optional
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "venue_id": {
      "description": "Venue id, from search_venues or an event card. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    },
    "status": {
      "description": "Filter by event status. upcoming = every card not yet over (announced, scheduled or live), soonest first.",
      "type": "string",
      "enum": [
        "announced",
        "scheduled",
        "live",
        "completed",
        "cancelled",
        "postponed",
        "upcoming"
      ]
    },
    "from": {
      "description": "Earliest event date, YYYY-MM-DD.",
      "type": "string"
    },
    "to": {
      "description": "Latest event date, YYYY-MM-DD.",
      "type": "string"
    },
    "order": {
      "description": "desc = newest first (default), asc = oldest first.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "required": [
    "venue_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

q	string	optional	Keyword, at least 2 characters: matches the title, summary or a tag.
tag	string	optional	Exact tag, e.g. "ufc".
locale	string	optional	Site language to serve (default en); English when no translation exists.
limit	integer	optional	Rows per page, default 10.
cursor	string	optional	meta.pagination.next_cursor from a previous call.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Keyword, at least 2 characters: matches the title, summary or a tag.",
      "type": "string",
      "minLength": 2
    },
    "tag": {
      "description": "Exact tag, e.g. \"ufc\".",
      "type": "string"
    },
    "locale": {
      "description": "Site language to serve (default en); English when no translation exists.",
      "type": "string",
      "enum": [
        "en",
        "es",
        "pt",
        "de",
        "fr",
        "tr",
        "ru",
        "ka",
        "ja",
        "ko",
        "pl",
        "sr",
        "zh"
      ]
    },
    "limit": {
      "description": "Rows per page, default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "meta.pagination.next_cursor from a previous call.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

slug	string	required	Article slug, from search_articles.
locale	string	optional	Site language to serve (default en); English when no translation exists.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Article slug, from search_articles."
    },
    "locale": {
      "description": "Site language to serve (default en); English when no translation exists.",
      "type": "string",
      "enum": [
        "en",
        "es",
        "pt",
        "de",
        "fr",
        "tr",
        "ru",
        "ka",
        "ja",
        "ko",
        "pl",
        "sr",
        "zh"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

org

string

required

Promotion slug.

Raw schema

{
  "type": "object",
  "properties": {
    "org": {
      "type": "string",
      "enum": [
        "ufc",
        "pfl",
        "oktagon",
        "bkfc",
        "rizin"
      ],
      "description": "Promotion slug."
    }
  },
  "required": [
    "org"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_webhook_endpoints

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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

Parameters2

url	string	required	https:// endpoint that will receive the signed POSTs.
events	array	optional	Event kinds to subscribe to; omit for all of them.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "https:// endpoint that will receive the signed POSTs."
    },
    "events": {
      "description": "Event kinds to subscribe to; omit for all of them.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

endpoint_id

any

required

Endpoint id from list_webhook_endpoints. Integer or numeric string.

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint_id": {
      "description": "Endpoint id from list_webhook_endpoints. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    }
  },
  "required": [
    "endpoint_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_webhook_endpoint

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

Parameters1

endpoint_id

any

required

Endpoint id from list_webhook_endpoints. Integer or numeric string.

Raw schema

{
  "type": "object",
  "properties": {
    "endpoint_id": {
      "description": "Endpoint id from list_webhook_endpoints. Integer or numeric string.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ]
    }
  },
  "required": [
    "endpoint_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md2 KBView on GitHub

UFCalendar Fight API — agent skill

An installable skill that teaches a coding agent how to reach the UFCalendar Fight API — the MMA Fight Data API behind our MCP server for UFC data and MMA MCP server: UFC, PFL, OKTAGON, BKFC and RIZIN events, full fight cards, results, per-round stats, fighter careers, judges' scorecards, UFC rankings history since 2013 and per-country broadcast rights — over REST, the two SDKs, or the MCP server at https://api.ufcalendar.com/mcp.

Install

bash

npx skills add UFCalendar/fight-api-skill

Or copy it in by hand:

Agent	Where
Claude Code	`.claude/skills/ufcalendar-fight-api/` (project) or `~/.claude/skills/ufcalendar-fight-api/` (global)
Cursor	paste `SKILL.md` into a rule under `.cursor/rules/`, keep `references/` beside it
Codex	reference `SKILL.md` from `AGENTS.md`, keep `references/` beside it

The skill is plain Markdown — SKILL.md plus four reference files. Nothing executes.

SKILL.md — access in 60 seconds, base URL and envelope, the endpoints that answer the common questions, the don'ts, and when to use MCP vs REST vs SDK.
references/endpoints.md — every endpoint and parameter. Generated from the OpenAPI document; do not edit by hand.
references/conventions.md — envelope, pagination, errors, rate headers, tier gates, webhook signature verification.
references/mcp-clients.md — copy-paste config for Claude Code, Cursor, Codex, Claude.ai and ChatGPT.
references/sdk.md — Python and TypeScript quickstarts.

Access

No free tier. A free 1-day trial (100 requests, no card, one per account) self-serves at https://www.ufcalendar.com/account/api?trial=1; paid plans start at $19/month. GET https://api.ufcalendar.com/v1/plans answers with no credential at all, so an agent can evaluate the API before anyone signs in.

Odds are the UFCalendar consensus line only (no book identities; information only, not betting advice). Fighter images are Creative Commons and must be shown with their credit. Not affiliated with UFC, Zuffa, TKO or any promotion.

MIT licensed.

Install

Tools (47)

get_planslist_orgshow_to_connectget_orgget_divisionlist_eventsget_next_eventget_event_card

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.ufcalendar.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "fight-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.ufcalendar.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.ufcalendar/fight-api (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_plans

list_orgs

how_to_connect

get_org

get_division

list_events

get_next_event

get_event_card

get_event_changes

list_changes

how_to_watch

get_event_storylines

get_pickem_splits

get_event_odds

get_fight_odds

get_odds_history

get_fight

find_fights

search

search_fighters

get_fighter

compare_fighters

get_rankings

get_champions

get_power_index

get_matchmaker

whos_next

get_leaderboard

get_record_book

get_year_stats

get_predictions_upcoming

get_broadcast_rights

list_judges

get_judge

get_judge_scorecards

list_split_decisions

get_usage

get_venue

search_venues

get_venue_events

search_articles

get_article

get_calendar_feed_url

list_webhook_endpoints

create_webhook_endpoint

rotate_webhook_secret

delete_webhook_endpoint

UFCalendar Fight API — agent skill

Install

Contents

Access

Install

Remote endpoint

Related servers