plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "fastballapi",
  "version": "1.0.0",
  "description": "FastballAPI brings MLB baseball data into ChatGPT and Codex with read-only tools and workflow skills: standings, schedules and scores, player batting and pitching lines, leaders, injuries, team ratings, plate appearances, pitches, pitch mix, spray charts, sportsbook odds and player prop lines. Sign in with your FastballAPI account.",
  "author": {
    "name": "FastballAPI",
    "email": "support@fastballapi.com",
    "url": "https://fastballapi.com"
  },
  "homepage": "https://fastballapi.com",
  "repository": "https://github.com/noahowsh/fastballapi-mcp",
  "license": "MIT",
  "keywords": [
    "mlb",
    "sports-data",
    "sports-analytics",
    "stats",
    "fastballapi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "FastballAPI",
        "shortDescription": "MLB baseball data and stats",
        "longDescription": "FastballAPI connects ChatGPT and Codex to MLB baseball data from FastballAPI. It covers MLB and college baseball with plate appearances, pitch-by-pitch data, pitch mix and spray charts.\n\nAsk for standings, schedules and scores, player batting and pitching lines, leaders, injuries, team ratings, plate appearances, pitches, pitch mix, spray charts, sportsbook odds and player prop lines. 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 FastballAPI account.\n\nLimits: FastballAPI 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 FastballAPI 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 FastballAPI's own Elo-style ratings, not official rankings. Not affiliated with MLB or any team.\n\nBundled skills teach the model how to choose the right tool for a question and how to explain results.",
        "developerName": "FastballAPI",
        "category": "Data & Analytics",
        "capabilities": [
          "Look up MLB and college baseball teams and players",
          "Read standings, schedules and scores",
          "Read batting, pitching and leaderboard stats",
          "Read pitches, pitch mix and spray charts",
          "Read sportsbook odds and prop lines (information only)"
        ],
        "websiteURL": "https://fastballapi.com",
        "supportURL": "https://fastballapi.com/support",
        "privacyPolicyURL": "https://fastballapi.com/privacy",
        "termsOfServiceURL": "https://fastballapi.com/terms",
        "defaultPrompt": [
          "Show the 2025 MLB standings.",
          "Find Aaron Judge and show his 2025 batting stats.",
          "Who led MLB in home runs in 2025?"
        ],
        "brandColor": "#3AB166",
        "brandColorDark": "#4ADE80",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "League standings",
              "prompt": "Show the 2025 MLB standings.",
              "tools_triggered": "get_standings",
              "expected_behavior": "Returns all 30 teams with wins, losses and run differential. Top records: Milwaukee 97-65, Philadelphia 96-66, Toronto 94-68 and New York Yankees 94-68."
            },
            {
              "description": "Player lookup and batting line",
              "prompt": "Find Aaron Judge and show his batting stats for 2025.",
              "tools_triggered": "search_players, get_player",
              "expected_behavior": "Finds Aaron Judge (player id 33192, Yankees, RF), then returns his 2025 batting line: .331 average, .457 OBP, .688 SLG, 1.144 OPS, 53 home runs in 679 plate appearances."
            },
            {
              "description": "Games on a date",
              "prompt": "What MLB games were played on October 1, 2025?",
              "tools_triggered": "get_games",
              "expected_behavior": "Returns postseason games on 2025-10-01 including Cincinnati 4 at Los Angeles Dodgers 8, Boston 3 at New York Yankees 4 and San Diego 3 at Chicago Cubs 0."
            },
            {
              "description": "Home run leaders",
              "prompt": "Who led MLB in home runs in 2025?",
              "tools_triggered": "get_leaders",
              "expected_behavior": "Returns qualified home run leaders: Cal Raleigh (SEA) 60, Kyle Schwarber (PHI) 56, Shohei Ohtani (LAD) 55, with the 502 plate appearance qualifier noted."
            },
            {
              "description": "Team ratings",
              "prompt": "Which MLB teams had the highest Elo ratings after the 2025 season?",
              "tools_triggered": "get_ratings",
              "expected_behavior": "Returns ranked Elo ratings: Los Angeles Dodgers 1578.3, Milwaukee Brewers 1564.4, Philadelphia Phillies 1559.5, and states they are FastballAPI's own ratings."
            }
          ],
          "negative": [
            {
              "description": "Place a wager: wagering is not supported",
              "prompt": "Place a $50 bet on the Yankees 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/fastballapi-chatgpt-walkthrough-gKXN6hvQBSEBv81V9h9anwmDfY40Ks.mp4",
        "commerce": false,
        "commerce_description": "FastballAPI 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 MLB baseball data tools with OAuth sign-in and 14 workflow skills."
      },
      "apps": "./.app.json"
    }
  }
}