plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "thestatsapi",
  "version": "1.0.6",
  "description": "Football (soccer) data from TheStatsAPI: fixtures, live scores, league tables, team and player stats, lineups, player ratings, referees, shot maps (xG) and heatmaps.",
  "author": {
    "name": "TheStatsAPI",
    "email": "support@thestatsapi.com",
    "url": "https://www.thestatsapi.com"
  },
  "homepage": "https://www.thestatsapi.com",
  "keywords": [
    "football",
    "soccer",
    "sports",
    "live scores",
    "statistics",
    "xG"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "TheStatsAPI Football",
        "shortDescription": "Live football scores and stats",
        "longDescription": "Ask about football (soccer) and get answers from TheStatsAPI's data: fixtures and results, live scores, league tables, team and player season stats, squads, injuries and suspensions, lineups, player ratings, referees, shot maps with expected goals (xG) and touch heatmaps.\n\nScoreboards, match cards, player ratings, league tables, shot maps and heatmaps open as interactive views in the chat. From a scoreboard you can open a match, from a table a team's matches, and from a match its ratings or shot map. Live matches refresh while you watch.\n\nWho it's for: fans, fantasy players, analysts, journalists and developers checking TheStatsAPI's data.\n\nYou need a TheStatsAPI account. Sign in once to connect it; requests then run on your own account.\n\nLimitations: football only. The plugin is read-only and can't change anything in your account. It doesn't provide betting odds or betting advice. Which competitions and seasons have which data (for example xG or heatmaps) depends on coverage; ask \"what data do you have for the Premier League?\" to check.",
        "developerName": "TheStatsAPI",
        "category": "Entertainment",
        "capabilities": [
          "Fixtures, results and live scores",
          "League tables",
          "Team and player stats",
          "Lineups and player ratings",
          "Shot maps (xG) and heatmaps"
        ],
        "websiteURL": "https://www.thestatsapi.com",
        "supportURL": "https://www.thestatsapi.com/contact",
        "privacyPolicyURL": "https://www.thestatsapi.com/privacy",
        "termsOfServiceURL": "https://www.thestatsapi.com/terms",
        "defaultPrompt": [
          "Show me the Premier League table.",
          "What football matches are on today?",
          "Show the shot map from Arsenal's last match."
        ],
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "League table with the table widget",
              "prompt": "Show me the Premier League table.",
              "tools_triggered": "search_competitions, get_standings",
              "expected_behavior": "Finds the English Premier League and shows the current season's table (position, played, points, goal difference, form) in the league table widget."
            },
            {
              "description": "A team's upcoming fixtures with the scoreboard widget",
              "prompt": "When does Arsenal play next?",
              "tools_triggered": "search_teams, find_matches",
              "expected_behavior": "Finds Arsenal and lists its next scheduled matches with date, kick-off time, opponent and competition in the scoreboard widget."
            },
            {
              "description": "Player season stats",
              "prompt": "How is Erling Haaland doing this season?",
              "tools_triggered": "search_players, get_player",
              "expected_behavior": "Finds Erling Haaland and summarises his current season: appearances, minutes, goals, assists and other stats, plus any current injury or suspension."
            },
            {
              "description": "Shot map with xG for a finished match",
              "prompt": "Show me the shot map from Liverpool's last match.",
              "tools_triggered": "search_teams, find_matches, get_shotmap",
              "expected_behavior": "Finds Liverpool's most recent finished match and shows every shot with its xG, each team's xG total and the best chances in the shot map widget."
            },
            {
              "description": "Player ratings for a finished match",
              "prompt": "Who were the best-rated players in Real Madrid's last match?",
              "tools_triggered": "search_teams, find_matches, get_match_player_stats",
              "expected_behavior": "Finds Real Madrid's most recent finished match and lists the players ranked by rating with their key stats in the player ratings widget."
            }
          ],
          "negative": [
            {
              "description": "Betting advice is out of scope: the plugin has no odds or betting tools",
              "prompt": "Which team should I bet on tonight and what are the odds?"
            },
            {
              "description": "Other sports are out of scope: the plugin only covers football (soccer)",
              "prompt": "Show me the current NBA standings."
            },
            {
              "description": "The plugin is read-only and can't buy or book anything",
              "prompt": "Buy me two tickets for Chelsea's next home game."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/W1JCzo-K1cU",
        "commerce": false
      },
      "publication": {
        "release_notes": "First release: fixtures, live scores, league tables, team and player stats, squads, lineups, player ratings, referees, shot maps (xG), heatmaps and data coverage, with interactive views in the chat."
      },
      "apps": "./.app.json"
    }
  }
}