plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "fighterapi",
  "version": "1.0.0",
  "description": "FighterAPI brings MMA data into ChatGPT and Codex with read-only tools and workflow skills: event cards and schedules, fight results and methods, fighter profiles and fight history, striking and grappling leaders, weight-class Elo ratings, sportsbook odds and line movement. Sign in with your FighterAPI account.",
  "author": {
    "name": "FighterAPI",
    "email": "support@fighterapi.com",
    "url": "https://fighterapi.com"
  },
  "homepage": "https://fighterapi.com",
  "repository": "https://github.com/noahowsh/fighterapi-mcp",
  "license": "MIT",
  "keywords": [
    "mma",
    "sports-data",
    "sports-analytics",
    "stats",
    "fighterapi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "FighterAPI",
        "shortDescription": "MMA fight data and stats",
        "longDescription": "FighterAPI connects ChatGPT and Codex to MMA data from FighterAPI. It covers the UFC, PFL and Bellator with events, cards, fights, fighter profiles and weight-class Elo ratings.\n\nAsk for event cards and schedules, fight results and methods, fighter profiles and fight history, striking and grappling leaders, weight-class Elo ratings, sportsbook odds and line movement. The plugin looks the answer up with read-only tools and reports what the data says, including the season, date and source of each number.\n\nThe first time you use it, you sign in with your FighterAPI account.\n\nLimits: FighterAPI is read-only. It cannot place wagers, accept or track bets, or edit your account. Odds and prop lines are shown as information about the market, not as advice. Data comes from public sources and the FighterAPI pipeline and is not guaranteed to be error-free or current to the minute, so do not rely on it as the sole basis for financial decisions. Ratings shown are FighterAPI's own Elo-style ratings, not official rankings. Not affiliated with the UFC, PFL, Bellator or any promotion.\n\nBundled skills teach the model how to choose the right tool for a question and how to explain results.",
        "developerName": "FighterAPI",
        "category": "Data & Analytics",
        "capabilities": [
          "Look up fighters, events and bouts",
          "Read upcoming cards and past results",
          "Read fighter profiles and fight history",
          "Read striking and grappling leaders",
          "Read Elo ratings and sportsbook odds (information only)"
        ],
        "websiteURL": "https://fighterapi.com",
        "supportURL": "https://fighterapi.com/support",
        "privacyPolicyURL": "https://fighterapi.com/privacy",
        "termsOfServiceURL": "https://fighterapi.com/terms",
        "defaultPrompt": [
          "Who are the top-rated UFC fighters right now?",
          "Show Ilia Topuria's last three fights.",
          "Which UFC fights are scheduled in the next 30 days?"
        ],
        "brandColor": "#FF6B78",
        "brandColorDark": "#FF6B78",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Top-rated fighters",
              "prompt": "Who are the top-rated UFC fighters right now?",
              "tools_triggered": "get_ratings",
              "expected_behavior": "Returns FighterAPI's own Elo ratings for fighters active since 2025: Islam Makhachev (Welterweight) 1736, Max Holloway (Lightweight) 1684, Charles Oliveira (Lightweight) 1680."
            },
            {
              "description": "Fighter lookup and profile",
              "prompt": "Find Ilia Topuria and show his profile.",
              "tools_triggered": "search_fighters, get_fighter",
              "expected_behavior": "Finds Ilia Topuria (fighter id 4350812, nickname El Matador, Lightweight, Georgia), then returns his profile: born 1997-01-21, 67 in height, 69 in reach, Orthodox stance, Climent Club."
            },
            {
              "description": "Recent fights",
              "prompt": "Show Ilia Topuria's last three fights.",
              "tools_triggered": "search_fighters, get_fighter_fights",
              "expected_behavior": "Returns three fights, newest first: UFC Freedom 250 on 2026-06-14 against Justin Gaethje (loss by KO/TKO in round 4), UFC 317 on 2025-06-28 against Charles Oliveira (win by KO/TKO), UFC 308 on 2024-10-26 against Max Holloway (win by KO/TKO)."
            },
            {
              "description": "Striking leaders",
              "prompt": "Who has the best significant strike accuracy in the UFC among fighters with at least five fights?",
              "tools_triggered": "get_leaders",
              "expected_behavior": "Returns the significant strike accuracy leaders: Cyrille Diabate (Light Heavyweight) 86.5 percent, Justin Willis (Heavyweight) 79.6 percent, Alistair Overeem (Heavyweight) 74.3 percent."
            },
            {
              "description": "Upcoming schedule",
              "prompt": "Which UFC fights are scheduled in the next 30 days?",
              "tools_triggered": "get_schedule",
              "expected_behavior": "Returns upcoming bouts grouped by event. On 2026-10-14 the first card was UFC Fight Night: Buckley vs. Malott on 2026-10-17, with 47 scheduled bouts across the window. Results depend on the date the test is run."
            }
          ],
          "negative": [
            {
              "description": "Place a wager: wagering is not supported",
              "prompt": "Place a $50 bet on Topuria to win tonight."
            },
            {
              "description": "Out of coverage: another sport",
              "prompt": "Show me the current NBA standings."
            },
            {
              "description": "Account and billing change: not supported",
              "prompt": "Buy 10,000 more credits and upgrade my plan to the highest tier."
            }
          ]
        },
        "demo_recording_url": "https://dwwkiy1hwsshare7.public.blob.vercel-storage.com/review/fighterapi-chatgpt-walkthrough-HqaFx51O0QVcgV6pO2oe5OkyrTlVlq.mp4",
        "commerce": false,
        "commerce_description": "FighterAPI does not sell anything through ChatGPT. The plugin is read-only: it has no checkout, purchase, subscription or credit top-up flow."
      },
      "publication": {
        "release_notes": "Initial release. Read-only MMA data tools with OAuth sign-in and 14 workflow skills."
      },
      "apps": "./.app.json"
    }
  }
}