plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "sportsapis-dev",
  "version": "1.1.0",
  "description": "Find, compare and read reviews of sports odds APIs and sports data APIs from the SportsAPIs.dev directory.",
  "author": {
    "name": "JediBets, LLC",
    "email": "info@sportsapis.dev",
    "url": "https://sportsapis.dev"
  },
  "homepage": "https://sportsapis.dev",
  "license": "UNLICENSED",
  "keywords": [
    "sports odds api",
    "sports data api",
    "sportsbook api",
    "live odds api",
    "esports odds api",
    "player props api",
    "developer tools"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SportsAPIs.dev",
        "shortDescription": "Find sports data & odds APIs",
        "longDescription": "SportsAPIs.dev helps developers pick a sports odds API or sports data API for the app, model or odds comparison tool they are building. The plugin answers from the SportsAPIs.dev directory: every provider is researched by hand and has a written review page.\n\nWhat it does:\n- Find sports APIs by what you need: sport or league (NFL, NBA, MLB, NHL, soccer, tennis, esports and more), live odds, WebSocket streaming, Bet365 or Pinnacle odds, historical and closing odds, player props, futures, same game parlay odds, bet deeplinks, bet settlement, stats, schedules, live scores, box scores, play-by-play and official MCP servers. Filter by free tier, price tier and region.\n- Compare two to four providers side by side on the same researched feature set, with the differences called out.\n- Read what the SportsAPIs.dev review says about one provider: feature support, pricing tiers, strengths, the full review text, FAQs and alternatives.\n\nEvery answer links to the matching review page on sportsapis.dev, so you can read the full write-up and reach the provider from there.\n\nWho it is for: developers building sports apps, betting tools, odds comparison sites, sports analytics, trading models or AI agents that need a sports odds API, a sportsbook odds feed or a sports data API.\n\nLimitations: the plugin covers API providers only. It has no live odds, no scores and no match data, and it gives no betting picks or wagering advice. Feature statuses come from SportsAPIs.dev research (yes, no, or unknown when unverified or plan-dependent). Sport lists reflect sports named in each written review, not a verified coverage list; check the provider's own docs before you build. Featured partners of SportsAPIs.dev rank first in search results and are labelled as featured partners. Some provider links carry SportsAPIs.dev referral parameters, disclosed on the site; they cost you nothing.",
        "developerName": "JediBets, LLC",
        "category": "Developer Tools",
        "capabilities": [
          "Find sports odds and data APIs",
          "Compare API providers",
          "Read provider reviews"
        ],
        "websiteURL": "https://sportsapis.dev",
        "supportURL": "https://sportsapis.dev/discord",
        "privacyPolicyURL": "https://sportsapis.dev/privacy",
        "termsOfServiceURL": "https://sportsapis.dev/terms",
        "defaultPrompt": [
          "Which sports odds API has live NFL odds, a WebSocket feed and a free tier?",
          "Compare The-Odds-API, OddsPapi and SportsGamesOdds for player props.",
          "Is there a sports data API with live scores and box scores for soccer?"
        ],
        "brandColor": "#0891B2",
        "brandColorDark": "#00D4FF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/1RwjRgj0ojuG9EJ-9Pwmz2XZYrj_h4AL7/view",
        "test_cases": {
          "positive": [
            {
              "description": "Filter the directory by sport, feature needs and free tier",
              "prompt": "Which sports odds API has live NFL odds, a WebSocket feed and a free tier?",
              "tools_triggered": "find_sports_apis",
              "expected_behavior": "Returns a ranked short list of providers whose live odds and WebSocket support are confirmed and that have a free tier, each with a one-line reason and a sportsapis.dev review URL."
            },
            {
              "description": "Compare named providers side by side",
              "prompt": "Compare The-Odds-API, OddsPapi and SportsGamesOdds for player props.",
              "tools_triggered": "compare_sports_apis",
              "expected_behavior": "Returns a feature table for the three providers, lists the features where they differ, notes that player props are mentioned in the reviews, and links each review page."
            },
            {
              "description": "Read the review of one provider by a loose name",
              "prompt": "Is the odds api free? What does it cost after that?",
              "tools_triggered": "get_sports_api_details",
              "expected_behavior": "Resolves \"the odds api\" to The-Odds-API and answers from the review's pricing section (free tier plus paid tiers), citing https://sportsapis.dev/apis/the-odds-api."
            },
            {
              "description": "Find sports data APIs without odds",
              "prompt": "Is there a sports data API with live scores and box scores for soccer?",
              "tools_triggered": "find_sports_apis",
              "expected_behavior": "Returns only providers in the sports data category whose live scores and box scores are confirmed and whose review mentions soccer, with review URLs."
            },
            {
              "description": "Handle an unknown provider name",
              "prompt": "What does the SportsAPIs.dev review say about Narnia Odds?",
              "tools_triggered": "get_sports_api_details",
              "expected_behavior": "Reports that no provider in the directory matches that name and offers to look up a similar name, without inventing a review."
            }
          ],
          "negative": [
            {
              "description": "Betting pick request",
              "prompt": "Who should I bet on in the Chiefs game tonight?"
            },
            {
              "description": "Request for live odds of a specific match",
              "prompt": "What are the current odds for Real Madrid vs Barcelona?"
            },
            {
              "description": "Request to place a wager",
              "prompt": "Put $50 on the Lakers moneyline for me."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin sells nothing and processes no payments. It returns facts about API providers and links to review pages on sportsapis.dev."
      },
      "publication": {
        "release_notes": "Initial release: find sports odds and data APIs by need, compare providers side by side, and read the SportsAPIs.dev review of any listed provider."
      },
      "apps": "./.app.json"
    }
  }
}