plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "live-football-api",
  "version": "1.0.3",
  "description": "Football (soccer) scores, fixtures, league tables, lineups and player data for leagues worldwide.",
  "author": {
    "name": "FORCESCRIPTS LTD",
    "email": "support@live-football-api.com",
    "url": "https://www.live-football-api.com"
  },
  "homepage": "https://www.live-football-api.com",
  "keywords": [
    "football",
    "soccer",
    "live scores",
    "fixtures",
    "standings",
    "lineups",
    "sports data"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Live Football API",
        "shortDescription": "Scores, fixtures & tables",
        "longDescription": "Look up football (soccer) data in ChatGPT by asking in plain language. Covers top divisions, cups and lower leagues across many countries.\n\nWhat you can ask for:\n- Matches on a given date with scores and live status, filtered by league, team or status\n- Match details: goals, cards, substitutions and match statistics\n- Starting lineups, formations, substitutes and coaches\n- Head-to-head history and recent form of two teams\n- League tables (overall, home and away) and season fixtures by round\n- Team squads, team fixtures and results\n- Player profiles and the matches a player appeared in\n- Injuries, suspensions and match officials\n\nHow it works: you sign in with your Live Football API account and choose which of your API keys ChatGPT may use. Requests are counted against that key the same way as direct API requests. You can disconnect at any time from the Connected apps section of your dashboard.\n\nThe app is read-only and never changes anything in your account. All times are in UTC.\n\nLimitations: data depth varies by competition; some lower-tier leagues have no lineups or match statistics. The app provides football information only and does not give betting or gambling advice.",
        "developerName": "FORCESCRIPTS LTD",
        "category": "Entertainment",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://www.live-football-api.com",
        "privacyPolicyURL": "https://www.live-football-api.com/privacy",
        "termsOfServiceURL": "https://www.live-football-api.com/terms",
        "supportURL": "https://www.live-football-api.com/contact",
        "defaultPrompt": [
          "Show me the current Premier League table.",
          "Who is in Real Madrid's squad this season?",
          "Give me Erling Haaland's profile and recent matches."
        ],
        "brandColor": "#22C55E",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "commerce": false,
        "test_cases": {
          "positive": [
            {
              "description": "Shows the current standings of a major league.",
              "prompt": "Show me the current Premier League table.",
              "tools_triggered": "list_leagues, get_league_standings",
              "expected_behavior": "A table with rank, team, played, won, drawn, lost, goal difference and points for the current Premier League season."
            },
            {
              "description": "Returns the results of the most recently played round of a league.",
              "prompt": "Show me the results of the last Premier League round.",
              "tools_triggered": "list_leagues, get_league_fixtures",
              "expected_behavior": "The matches of the latest completed Premier League round with final scores."
            },
            {
              "description": "Finds a team by name and lists its squad.",
              "prompt": "Who is in Real Madrid's squad this season?",
              "tools_triggered": "search_teams, get_team_squad",
              "expected_behavior": "Real Madrid players grouped or labelled by position."
            },
            {
              "description": "Lists a team's matches for the season.",
              "prompt": "Show Barcelona's fixtures and results for this season.",
              "tools_triggered": "search_teams, get_team_matches",
              "expected_behavior": "Barcelona's played matches with scores and upcoming matches with dates (UTC)."
            },
            {
              "description": "Looks up a player and shows profile and recent matches.",
              "prompt": "Give me Erling Haaland's profile and his recent matches.",
              "tools_triggered": "search_players, get_player, get_player_matches",
              "expected_behavior": "Team, position, nationality and age, plus a list of recent matches."
            }
          ],
          "negative": [
            {
              "description": "Betting advice. The plugin provides football information only. Expected: declines to give betting advice or sure bets; may offer neutral information such as fixtures or recent form instead.",
              "prompt": "Which team should I bet on tonight to make money? Give me a sure bet."
            },
            {
              "description": "Unsupported sport. The plugin covers football (soccer) only. Expected: the plugin is not used, or ChatGPT explains it only covers football; no football tool is called.",
              "prompt": "What are the current NBA standings?"
            },
            {
              "description": "Account changes. The plugin is read-only and cannot manage keys, billing or the account. Expected: explains this and points the user to https://www.live-football-api.com/dashboard; no tool performs any change.",
              "prompt": "Delete my Live Football API key and buy more credits for me."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Updated descriptions and subtitle. Read-only access to football data (scores, fixtures, standings, lineups, head-to-head, squads, players, injuries and officials). Users connect with OAuth and choose which of their Live Football API keys ChatGPT may use."
      },
      "apps": "./.app.json"
    }
  }
}