plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "birdieapi",
  "version": "1.0.0",
  "description": "BirdieAPI brings golf data into ChatGPT and Codex with read-only tools and workflow skills: tournament schedules and leaderboards, scorecards, course history, player results and season stats, head-to-head comparisons, player ratings, season leaders and outright winner odds. Sign in with your BirdieAPI account.",
  "author": {
    "name": "BirdieAPI",
    "email": "support@birdieapi.com",
    "url": "https://birdieapi.com"
  },
  "homepage": "https://birdieapi.com",
  "repository": "https://github.com/noahowsh/birdieapi-mcp",
  "license": "MIT",
  "keywords": [
    "golf",
    "sports-data",
    "sports-analytics",
    "stats",
    "birdieapi"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BirdieAPI",
        "shortDescription": "Golf data and stats",
        "longDescription": "BirdieAPI connects ChatGPT and Codex to golf data from BirdieAPI. It covers the PGA Tour, LPGA, LIV, DP World Tour and Korn Ferry Tour with leaderboards, scorecards, course history and scoring stats.\n\nAsk for tournament schedules and leaderboards, scorecards, course history, player results and season stats, head-to-head comparisons, player ratings, season leaders and outright winner odds. 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 BirdieAPI account.\n\nLimits: BirdieAPI 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 BirdieAPI 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 BirdieAPI's own Elo-style ratings, not official rankings. Not affiliated with any tour or tournament.\n\nBundled skills teach the model how to choose the right tool for a question and how to explain results.",
        "developerName": "BirdieAPI",
        "category": "Data & Analytics",
        "capabilities": [
          "Look up golfers and tournaments across major tours",
          "Read schedules, leaderboards and scorecards",
          "Read player season stats and results",
          "Compare golfers head to head",
          "Read ratings and outright winner odds (information only)"
        ],
        "websiteURL": "https://birdieapi.com",
        "supportURL": "https://birdieapi.com/support",
        "privacyPolicyURL": "https://birdieapi.com/privacy",
        "termsOfServiceURL": "https://birdieapi.com/terms",
        "defaultPrompt": [
          "List the 2025 major championships.",
          "Show me the final leaderboard for the 2025 Masters.",
          "Who are the top three golfers by current rating?"
        ],
        "brandColor": "#78AB26",
        "brandColorDark": "#A3E635",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Major championships list",
              "prompt": "List the 2025 major championships.",
              "tools_triggered": "list_tournaments",
              "expected_behavior": "Returns the four 2025 majors with dates: Masters Tournament (2025-04-10), PGA Championship (2025-05-15), U.S. Open (2025-06-12), The Open (2025-07-17)."
            },
            {
              "description": "Player lookup and season stats",
              "prompt": "Find Scottie Scheffler and show his 2025 season stats.",
              "tools_triggered": "search_players, get_player_stats",
              "expected_behavior": "Finds Scottie Scheffler (player id 9478, USA), then returns 2025: 21 starts, 6 wins, 18 top tens, 5.9 average finish, 67.94 scoring average and $27,659,552 in earnings."
            },
            {
              "description": "Tournament leaderboard",
              "prompt": "Show me the final leaderboard for the 2025 Masters.",
              "tools_triggered": "list_tournaments, get_leaderboard",
              "expected_behavior": "Resolves tournament id 401703504 and returns the final leaderboard. Rory McIlroy finished first at 11 under (277 strokes) after a playoff, earning $4,200,000, with round scores 72, 66, 66, 73."
            },
            {
              "description": "Player ratings",
              "prompt": "Who are the top three golfers by current rating?",
              "tools_triggered": "get_ratings",
              "expected_behavior": "Returns BirdieAPI's own ratings as of 2026-10-11: Scottie Scheffler 3.31, Rory McIlroy 2.39, Tommy Fleetwood 2.19."
            },
            {
              "description": "Head to head",
              "prompt": "How do Scottie Scheffler and Rory McIlroy compare head to head in 2025?",
              "tools_triggered": "search_players, get_head_to_head",
              "expected_behavior": "Returns 13 shared tournaments in 2025: Scheffler ahead in 8, McIlroy ahead in 4, one tie, and a better round in 31 of 52 shared rounds for Scheffler (averaging 0.65 strokes per round better)."
            }
          ],
          "negative": [
            {
              "description": "Place a wager: wagering is not supported",
              "prompt": "Place a $50 bet on Scheffler 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/birdieapi-chatgpt-walkthrough-ClW5qxPmoDNAvNl6f7Qins3gSVc0z1.mp4",
        "commerce": false,
        "commerce_description": "BirdieAPI 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 golf data tools with OAuth sign-in and 14 workflow skills."
      },
      "apps": "./.app.json"
    }
  }
}