FighterAPI

Official11 tools

by noahowsh · JavaScript

UFC fights since 2000, plus PFL and Bellator: results, round stats, fighters and odds. REST and MCP.

io.github.noahowsh/fighterapi — MCP Server

This MCP server provides UFC fight data since 2000, along with results from PFL and Bellator, including round statistics, fighter information, and betting odds. It exposes the functionality via both REST and MCP for programmatic access.

🛠️ Key Features

UFC fights since 2000
PFL and Bellator results
Round stats
Fighters and odds
REST and MCP interfaces

🚀 Use Cases

Retrieve fight results and round-level statistics for UFC, PFL, and Bellator
Access fighter profiles and betting odds
Build applications that integrate fight data through MCP or REST

⚡ Developer Benefits

Consistent access via MCP for tool-based workflows
Alternative REST API availability
Supports odds and round stats alongside results and fighters

⚠️ Limitations

Scope is limited to UFC (since 2000), plus PFL and Bellator.

Topics

apimcpmcp-servermmasports-bettingsports-dataufcpythonnodejsapi-clientagent-skillsclaude-skillssports-analyticscodex-plugingemini-cli-extension

Captured live from the server via tools/list.

list_events

Use to find cards. Lists events newest first with the venue, status, number of fights and main event. Filter by season (year) and status (scheduled or final). Costs 1 credit.

Parameters5

season	string \| number	optional	Year, e.g. 2025.
status	string	optional	Only upcoming or only completed cards.
limit	integer	optional	Max events (default 50).
offset	integer	optional	Page offset; use next_offset.
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Year, e.g. 2025.",
      "type": [
        "string",
        "number"
      ]
    },
    "status": {
      "description": "Only upcoming or only completed cards.",
      "type": "string",
      "enum": [
        "scheduled",
        "final"
      ]
    },
    "limit": {
      "description": "Max events (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "description": "Page offset; use next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_event

Use for one card: every fight in order with the result, method, round and time, judges' scores and referee. Costs 2 credits.

Parameters2

event_id	string	required	Event id from list_events or get_schedule.
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string",
      "description": "Event id from list_events or get_schedule."
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "required": [
    "event_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_schedule

Use for upcoming fights: every scheduled bout in the next N days (default 30) with the current moneyline from any book that has posted one. Costs 2 credits.

Parameters2

days	integer	optional	Days ahead (default 30, max 180).
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Days ahead (default 30, max 180).",
      "type": "integer",
      "minimum": 1,
      "maximum": 180
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fight

Use for everything about one fight: the result, both fighters' full stat sheets (strikes by target and position, takedowns, control time, guard passes, reversals, submission attempts; UFC only, null elsewhere and where the source has no sheet), round-by-round lines (UFC only), each fighter's rating before and after, and the opening and closing moneyline from each book that posted one (2024 on). Costs 5 credits.

Parameters2

bout_id	string	required	Fight id (bout_id) from get_event or get_fighter_fights.
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "bout_id": {
      "type": "string",
      "description": "Fight id (bout_id) from get_event or get_fighter_fights."
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "required": [
    "bout_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_fighters

Use to find a fighter's id by name or nickname (accents optional). Returns weight class, country, pro record, number of fights in the promotion (bouts; ufc_bouts for the UFC only) and last fight date. Costs 1 credit.

Parameters4

query	string	required	Name or nickname, e.g. Topuria or 'El Matador'.
weight_class	string	optional	e.g. Lightweight, Women's Strawweight.
limit	integer	optional	Max results (default 20).
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Name or nickname, e.g. Topuria or 'El Matador'."
    },
    "weight_class": {
      "description": "e.g. Lightweight, Women's Strawweight.",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fighter

Use for one fighter's profile: date of birth, height, reach, stance, gym, record in the promotion by method (record; ufc_record is the same for the UFC and null for other promotions), career rates per 15 minutes from the stat sheets (significant strikes landed and absorbed, accuracy, defense, takedowns, submission attempts, control share; UFC only), current and peak rating, and the last five fights. Costs 5 credits.

Parameters2

fighter_id	string	required	Fighter id from search_fighters.
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "fighter_id": {
      "type": "string",
      "description": "Fighter id from search_fighters."
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "required": [
    "fighter_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fighter_fights

Use for a fighter's full history in the promotion: every fight with the opponent, result, method, round, time, strikes landed and absorbed and takedowns (UFC only), rating before and after, and the median closing moneyline across sportsbooks. Costs 5 credits.

Parameters4

fighter_id	string	required	Fighter id from search_fighters.
limit	integer	optional	Max fights (default 50).
offset	integer	optional	Page offset; use next_offset.
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "fighter_id": {
      "type": "string",
      "description": "Fighter id from search_fighters."
    },
    "limit": {
      "description": "Max fights (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "description": "Page offset; use next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "required": [
    "fighter_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_leaders

Use for career leaderboards computed from every fight's stat sheet: sig_landed_per_15 (significant strikes landed per 15 min), sig_absorbed_per_15 (significant strikes absorbed per 15 min), sig_accuracy (significant strike accuracy), sig_defense (significant strike defense), td_per_15 (takedowns landed per 15 min), td_accuracy (takedown accuracy), td_defense (takedown defense), knockdowns (knockdowns), sub_attempts_per_15 (submission attempts per 15 min), control_share (share of fight time in control), finish_rate (wins by KO/TKO or submission, as a share of wins). Filter by weight class, a starting year, and a minimum number of fights (default 5). Costs 5 credits.

Parameters5

stat	string	required	Which leaderboard.
weight_class	string	optional	Only fights in this weight class, e.g. Lightweight.
since	string \| number	optional	Only fights from this year on, e.g. 2020.
min_fights	integer	optional	Minimum fights to qualify (default 5).
limit	integer	optional	Max fighters (default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "stat": {
      "type": "string",
      "enum": [
        "sig_landed_per_15",
        "sig_absorbed_per_15",
        "sig_accuracy",
        "sig_defense",
        "td_per_15",
        "td_accuracy",
        "td_defense",
        "knockdowns",
        "sub_attempts_per_15",
        "control_share",
        "finish_rate"
      ],
      "description": "Which leaderboard."
    },
    "weight_class": {
      "description": "Only fights in this weight class, e.g. Lightweight.",
      "type": "string"
    },
    "since": {
      "description": "Only fights from this year on, e.g. 2020.",
      "type": [
        "string",
        "number"
      ]
    },
    "min_fights": {
      "description": "Minimum fights to qualify (default 5).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "limit": {
      "description": "Max fighters (default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "stat"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_ratings

Use for our fighter ratings: an Elo built from the promotion's own results (the UFC since 2000), highest first, for fighters active since a given year (default last year). Filter by weight class. Costs 2 credits.

Parameters4

weight_class	string	optional	e.g. Welterweight.
active_since	string \| number	optional	Only fighters whose last fight was in this year or later.
limit	integer	optional	Max fighters (default 25).
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "weight_class": {
      "description": "e.g. Welterweight.",
      "type": "string"
    },
    "active_since": {
      "description": "Only fighters whose last fight was in this year or later.",
      "type": [
        "string",
        "number"
      ]
    },
    "limit": {
      "description": "Max fighters (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_odds

Use for betting lines: each posted sportsbook's opening, closing and current moneyline for both fighters, with implied probabilities and the total-rounds line. Opening and closing lines start with the UFC cards of June 2020; a median of 5 to 7 books per fight (ESPN's own feed is one book per fight since mid-2024). Pass bout_id for one fight (5 credits) or event_id for a whole card (10 credits).

Parameters3

bout_id	string	optional	One fight.
event_id	string	optional	A whole card.
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "bout_id": {
      "description": "One fight.",
      "type": "string"
    },
    "event_id": {
      "description": "A whole card.",
      "type": "string"
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_line_movement

Use to see how a fight's line moved before the bell: our snapshots of each posted moneyline, from first capture to fight day (ESPN's once a day from October 2026, The Odds API's every hour in the two days before). Costs 10 credits.

Parameters3

bout_id	string	required	Fight id.
provider	string	optional	One sportsbook, e.g. DraftKings.
league	string	optional	League. Defaults to mma. One of: mma, pfl, bellator.

Raw schema

{
  "type": "object",
  "properties": {
    "bout_id": {
      "type": "string",
      "description": "Fight id."
    },
    "provider": {
      "description": "One sportsbook, e.g. DraftKings.",
      "type": "string"
    },
    "league": {
      "description": "League. Defaults to mma. One of: mma, pfl, bellator.",
      "type": "string",
      "enum": [
        "mma",
        "pfl",
        "bellator"
      ]
    }
  },
  "required": [
    "bout_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md8 KBView on GitHub

FighterAPI MCP server

The fight data API. Results, judges' scorecards and the full stat sheet for nearly every UFC fight since 2000, round by round, plus PFL (2012 on) and Bellator (2009 to 2024) results, fighters and ratings with the same key. Fighter profiles, career rates, our own ratings and sportsbook moneylines (UFC from June 2020, PFL from April 2023, Bellator from January 2022 to 2024). REST API and MCP server. 500 free credits every month, no card.

Website: https://fighterapi.com · Docs: https://fighterapi.com/docs · Get a key: https://fighterapi.com/signup

code

You:    "What is Islam Makhachev's significant strike accuracy by round across his UFC fights?"
Claude: [calls get_fighter_fights]

You:    "Show the opening and closing moneyline for every main event this year."
Claude: [calls get_odds]

Run it locally (stdio)

Most clients connect to https://mcp.fighterapi.com/mcp directly. For a client that launches a local process instead:

bash

git clone https://github.com/noahowsh/fighterapi-mcp.git && cd fighterapi-mcp && npm install
FIGHTERAPI_API_KEY=your_key node index.js

json

{ "mcpServers": { "fighterapi": { "command": "node", "args": ["/path/to/fighterapi-mcp/index.js"], "env": { "FIGHTERAPI_API_KEY": "your_key" } } } }

It forwards to the hosted server with your key, so every tool and credit cost is the same.

Skills

Sixteen Claude skills that turn Claude into an MMA analyst wired to these tools: fight and card lookup, fighter scouting, per-round striking and grappling rates, Elo by weight class, odds comparison and devigging, favourite calibration, edge detection and backtesting. They are plain SKILL.md files in skills/.

bash

git clone https://github.com/noahowsh/fighterapi-mcp

Or install them as a Claude Code plugin:

code

/plugin marketplace add noahowsh/fighterapi-mcp
/plugin install fighterapi-skills@fighterapi

Or with the skills CLI: npx skills add noahowsh/fighterapi-mcp.

Point Claude at the skills/ folder (for Claude Code, copy or symlink the skill folders into ~/.claude/skills/ or a project's .claude/skills/), connect the MCP server below, and ask. Start with skills/dispatch if you are unsure which skill fits. Full catalog: skills/README.md.

Useful pages

Docs and every tool: https://fighterapi.com/docs
Guides: https://fighterapi.com/guides
UFC odds: https://fighterapi.com/odds
Data coverage: https://fighterapi.com/data
Pricing: https://fighterapi.com/pricing
Compare: ESPN MMA API, Kaggle UFC dataset, Sportradar and SportsDataIO, UFC Stats scraper

Python

The official Python client is on PyPI: fighterapi.

bash

pip install fighterapi
export FIGHTERAPI_API_KEY=sk_live_...

python

from fighterapi import Client

client = Client()

events = client.list_events(status="final", limit=3)["events"]
for e in events:
    print(e["event_id"], e["event_date"], e["name"])

Typed errors for a bad key, no credits left, not found and rate limits, automatic retries, and to_dataframe for pandas.

Quick start

This is a hosted (remote) MCP server over Streamable HTTP. There is nothing to install.

Claude Code

bash

claude mcp add --transport http fighterapi "https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop, Cursor and other clients

json

{
  "mcpServers": {
    "fighterapi": {
      "url": "https://mcp.fighterapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

The key can also be sent as an x-api-key header or Authorization: Bearer. Connecting and listing tools works without a key; calling a tool needs one.

REST

bash

curl -X POST https://mcp.fighterapi.com/v1/list_events -H "x-api-key: YOUR_API_KEY"

Every tool is POST /v1/{tool} with a JSON body.

Examples

Runnable Python (standard library only) and Node 18+ (no dependencies) examples live in examples/:

examples/python/quickstart.py and examples/node/quickstart.mjs: schedule plus a headline call.
examples/python/mma_fighter_record_and_odds.py: A fighter profile (UFC record by method, Elo, career strike and takedown rates), their recent fights with the median closing line, and every sportsbook's open and close moneyline for their latest fight.

bash

export FIGHTERAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs

See examples/README.md for details. Get a free key (500 credits a month, no card) at https://fighterapi.com/signup.

Tools (11)

Tool	What it returns
`list_events`	Cards by year and status, with the main event
`search_fighters`	Find fighters by name or nickname
`get_event`	A card's fights with results, method, round, time and judges' scores
`get_schedule`	Upcoming fights with current moneylines where a book has posted one
`get_ratings`	Our fighter ratings (Elo from every UFC result since 2000)
`get_fight`	One fight: result, full stat sheets, round-by-round lines, ratings and odds
`get_fighter`	Profile, UFC record by method, career rates, rating and recent fights
`get_fighter_fights`	A fighter's full UFC history with stats, ratings and closing lines
`get_leaders`	Career leaderboards from every fight's stat sheet
`get_odds`	Opening, closing and current moneylines by sportsbook for a fight (5) or a card (10)
`get_line_movement`	Snapshots of each posted line before a fight

Leagues: mma (default, UFC), pfl, bellator (pass league to any tool).

Data

Every UFC card since 2000 with results, method, round, time and judges' scorecards; the full stat sheet, round by round, for nearly every card
PFL (2012 on) and Bellator (2009 to 2024) results, fighters and ratings; no stat sheets exist for those promotions in recent years
Fighter profiles with reach, stance and gym, career rates by method, and our Elo ratings from every UFC result since 2000
Moneylines and total rounds, no props: UFC opening and closing lines from June 2020 (a median of 5 to 7 books per fight; ESPN's own feed is usually one book since mid-2024), PFL from April 2023 and Bellator from January 2022 to 2024 with fewer books; pre-fight snapshots: ESPN's once a day from October 2026, The Odds API's every hour in the two days before a fight

Coverage by season, read live from the database: https://fighterapi.com/docs

Pricing

500 free credits every month, no card. Plans: Starter $19/mo (10,000 credits), Pro $49/mo (30,000), Scale $149/mo (125,000). Wallet top-ups from $5, never expire. https://fighterapi.com/pricing

Attribution

Fight data from public ESPN data; sportsbook lines from ESPN and The Odds API; round-by-round statistics compiled by UFC Stats (FightMetric). Ratings are ours. Not affiliated with the UFC, PFL, Bellator or any promotion.

License

MIT for the contents of this repository. Data terms as above.

Use with Codex

Add this repo as a Codex plugin marketplace, then install the plugin:

bash

codex plugin marketplace add noahowsh/fighterapi-mcp

Then open the plugin directory in Codex and install fighterapi-skills from the fighterapi marketplace. The plugin bundles the skills in skills/ and the FighterAPI MCP server (https://mcp.fighterapi.com/mcp). Set your key first (free at https://fighterapi.com/signup):

bash

export FIGHTERAPI_API_KEY=your_key

Codex sends it as a bearer token.

Use with Gemini CLI

bash

export FIGHTERAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/fighterapi-mcp

The extension adds the FighterAPI MCP server (https://mcp.fighterapi.com/mcp) and sends the key in the x-api-key header. Get a free key (500 credits a month) at https://fighterapi.com/signup.

Install

Tools (11)

list_eventsget_eventget_scheduleget_fightsearch_fightersget_fighterget_fighter_fightsget_leaders

Remote endpoint

Streamable HTTP

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

url

https://mcp.fighterapi.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

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

io.github.noahowsh/fighterapi — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_events

get_event

get_schedule

get_fight

search_fighters

get_fighter

get_fighter_fights

get_leaders

get_ratings

get_odds

get_line_movement

FighterAPI MCP server

Run it locally (stdio)

Skills

Useful pages

Python

Quick start

Examples

Tools (11)

Data

Pricing

Attribution

License

Use with Codex

Use with Gemini CLI

Install

Remote endpoint

Related servers