Documentation / More

MCP tools

Every tool on the MCP server at https://api.boxingapi.net/mcp, generated from the same list as the API. Each tool calls one endpoint with your key, on your plan's limits. Connecting an assistant

my_usage

Free key

Your plan, calls today and this month, your limits, when they reset and how far back your plan reaches. Never counts against your quota.

Calls: GET /v1/usage
Parameters: None

yesterdays_results

Free key

Every bout decided yesterday (UTC), professional first.

Calls: GET /v1/results/yesterday
Parameters: kind: The kind of bout

todays_results

Free key

Every bout decided so far today (UTC), professional first. A card still being boxed fills in as it goes.

Calls: GET /v1/results/today
Parameters: kind: The kind of bout

title_fights

Live and above

Professional bouts with a title at stake, newest first. q matches words in the title line (wbc heavyweight); filter by dates, fighter and women's bouts. Your plan sets how far back the list reaches.

Calls: GET /v1/title-fights
Parameters: q: Part of a namefrom: From this day, YYYY-MM-DDto: To this day, YYYY-MM-DDfighter: A fighter id (fi_)women: true for women's only, false for men's

upcoming_fights

Free key

Scheduled bouts in the coming days, soonest first, with the best price on each side and the chance it implies. Prices are on Live and above.

Calls: GET /v1/fights/upcoming
Parameters: days: How many days ahead; 1 to 30; default 7

find_bouts

Free key

Bouts, newest first, by date or a date range, kind, fighter, women's or men's, method, promoter (part of the name), and disputed (the records we hold split evenly on the result). Your plan sets how far back the list reaches.

Calls: GET /v1/bouts
Parameters: date: One day, YYYY-MM-DDfrom: From this day, YYYY-MM-DDto: To this day, YYYY-MM-DDkind: The kind of boutfighter: A fighter id (fi_)women: true for women's only, false for men'smethod: How it endeddisputed: true for results the records split onpromoter: Part of the promoter's name

get_bout

Free key

One bout in full: both fighters, the result, method, round, titles, venue, referee, each judge's card and, on Complete, the opening and closing prices.

Calls: GET /v1/bouts/{id}
Parameters: id required: An id starting bt_, as another call returns it

find_fighter

Live and above

Fighters whose name matches, the busiest first.

Calls: GET /v1/fighters
Parameters: q required: Part of a name

get_fighter

Live and above

A fighter's profile, professional record, wins inside the distance, our rating and points, and any commission suspension still in force.

Calls: GET /v1/fighters/{id}
Parameters: id required: An id starting fi_, as another call returns it

fighter_next_fights

Live and above

The fights to come for one fighter, soonest first, with the opponent and the best price on each side. An empty list means nothing is booked that we hold.

Calls: GET /v1/fighters/{id}/next
Parameters: id required: An id starting fi_, as another call returns it

get_rankings

Free key

The latest ranking lists of the four bodies (wbc, wba, ibf, wbo), the independent board (board) and our own rating (bxr) and points (bxp) tables, with champions. Past months are on Archive.

Calls: GET /v1/rankings
Parameters: body: Which listdivision: A division, as heavyweight or super-middleweightwomen: true for women's only, false for men'smonth: A past month, YYYY-MM (Archive)

fighter_rankings

Live and above

Every current list a fighter is champion of or ranked in, across the bodies, the board and our own tables.

Calls: GET /v1/fighters/{id}/rankings
Parameters: id required: An id starting fi_, as another call returns it

get_upsets

Complete

Underdog wins ranked by the winner's closing price. Filter by year, minimum price, title fights and women's bouts; sort by price or date.

Calls: GET /v1/upsets
Parameters: year: One year; 1990 to 2100min_odds: The winner's closing price at least, American; 100 to 100000; default 300title: true for title fights onlywomen: true for women's only, false for men'ssort: The order; default price

win_streaks

Live and above

Current runs of professional wins (or losses with losing=true), the longest first, with each fighter's best winning run. Active fighters unless active=false.

Calls: GET /v1/stats/streaks
Parameters: min: A run of at least this many; 1 to 200; default 5losing: true for losing runsactive: true for those active in the last 2 yearswomen: true for women's only, false for men's

record_quality

Free key

Field by field: how often two independent records agree on a bout's date, method, round, venue, referee, title and more, and how full each field is across professional results. Counted every hour.

Calls: GET /v1/stats/quality
Parameters: None

head_to_head

Archive and above

Every meeting of two fighters, of any kind, in order, with the tally of wins, draws and no contests.

Calls: GET /v1/fighters/{id}/vs/{other}
Parameters: id required: An id starting fi_, as another call returns itother required: An id starting fi_, as another call returns it

find_events

Live and above

Named events outside the professional record: amateur tournaments, Olympic events, exhibition, bare-knuckle and influencer cards, newest first. Filter by kind, year, name and women's bouts.

Calls: GET /v1/events
Parameters: kind: The kind of boutyear: One year; 1800 to 2100q: Part of a namewomen: true for women's only, false for men's

event_bouts

Live and above

Every bout of one event in order, as far back as your plan reaches.

Calls: GET /v1/events/{id}/bouts
Parameters: id required: An id starting ev_, as another call returns it

PreviousYour usage