FighterAPI MCP server

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

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:

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

{ "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/.

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

Or install them as a Claude Code plugin:

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

pip install fighterapi
export FIGHTERAPI_API_KEY=sk_live_...

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

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

Claude Desktop, Cursor and other clients

{
  "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

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.

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; usually one book since mid-2024), PFL from April 2023 and Bellator from January 2022 to 2024 with fewer books; pre-fight snapshots: once a day from October 2026, and 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

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:

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

export FIGHTERAPI_API_KEY=your_key

Codex sends it as a bearer token.

Use with Gemini CLI

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.