Bodybuilding Data API

The OpenAPI 3.0 specification is available as JSON for client generators, API explorers, and validation tools.

A Model Context Protocol (MCP) server lets AI assistants and agents query this database directly as tools.

It is a thin adapter over the public REST API above, so there is no separate data path, and its tool definitions are generated from the OpenAPI specification, so they always match the live endpoints.

The source ships with the plugin under bodybuilding/mcp/ (plain Node, no build step).

The bundled adapter currently makes anonymous API requests. Use the REST API directly for keyed requests. To register the server with a desktop AI client, add an entry like this to its MCP configuration:

Copy{
  "mcpServers": {
    "bodybuilding-database": {
      "command": "node",
      "args": ["/absolute/path/to/bodybuilding/mcp/index.js"],
      "env": { "BB_API_BASE": "https://fitnessvolt.com/wp-json/bodybuilding/v1" }
    }
  }
}

The server exposes tools for search, athletes, contests, divisions, rankings, GOAT, head-to-head compare, on this day, records, and Mr. Olympia. Every response carries the same attribution requirement described below.

This catalog is generated from the registered WordPress REST routes in the bodybuilding/v1 namespace. It lists public read endpoints only.

Odds board pages use generated snapshots and prediction data. No separate public REST /odds route is registered; use /predictions for prediction payloads.

Retrieve a paginated list of bodybuilding athletes. Supports filtering by division, country, gender, and active status, plus text search.

Retrieve detailed information for a single athlete, including career statistics and full competition result history.

Retrieve a paginated list of bodybuilding contests. Filter by year, tier, or search by name.

Retrieve full details for a single contest, including all division results and placings.

Retrieve all 13 canonical IFBB Pro divisions with athlete counts and metadata.

Retrieve detailed information for a single division, including top athletes and historical data.

Retrieve athlete rankings by total wins, Olympia wins, Arnold wins, and other statistical categories. Filterable by division.

Retrieve the Greatest of All Time composite rankings, factoring in Olympia titles, total wins, longevity, and dominance.

Retrieve Mr. Olympia results. Returns all years by default, or filter by year and division.

Retrieve Arnold Classic results. Returns all years by default, or filter by year and division.

Retrieve countries with codes, athlete counts, win totals, and active-athlete counts.

Global search across athletes and contests. Returns grouped results by type.

Retrieve aggregate database statistics: total athletes, contests, results, division types, provenance, and year coverage.

Retrieve bodybuilding events that happened on a given date in history. Defaults to today's date.

Retrieve data-driven contest predictions based on recent form, historical performance, and win momentum.

The Bodybuilding Database API is free for non-commercial use with attribution required. Requests are rate-limited per IP (60 per minute; 600 with an optional API key).

Cache responses, stay within the limit, and link back to the source when publishing data, charts, widgets, or derived research.