`get_competition_standings`

Pack: football-data · Endpoint: https://gateway.pipeworx.io/football-data/mcp

League table for a competition season. Returns total / home / away tables.

Parameters

Name	Type	Required	Description
`competition`	string	yes	Competition code
`season`	number	no	Season start year (optional, defaults current)
`matchday`	number	no	Standings as of a specific matchday (optional)

Example call

Arguments

{
  "competition": "PL"
}

curl

curl -X POST https://gateway.pipeworx.io/football-data/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_competition_standings","arguments":{"competition":"PL"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_competition_standings', {
  "competition": "PL"
});

More examples

{
  "competition": "PD",
  "season": 2024,
  "matchday": 10
}

Response shape

Always returns: competition, standings

Field	Type	Description
`competition`	string	Competition name or code
`standings`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "competition": {
      "type": "string",
      "description": "Competition name or code"
    },
    "standings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "stage": {
            "type": [
              "string",
              "null"
            ],
            "description": "Stage name (e.g., FINAL_STANDINGS)"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Standings type (TOTAL, HOME, AWAY)"
          },
          "group": {
            "type": [
              "string",
              "null"
            ],
            "description": "Group name if applicable"
          },
          "table": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "position": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Table position"
                },
                "team": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Team name"
                },
                "team_id": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Team ID"
                },
                "played": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Games played"
                },
                "won": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Games won"
                },
                "draw": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Games drawn"
                },
                "lost": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Games lost"
                },
                "gf": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Goals for"
                },
                "ga": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Goals against"
                },
                "gd": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Goal difference"
                },
                "points": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "description": "Total points"
                },
                "form": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Recent form (W/D/L sequence)"
                }
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "competition",
    "standings"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "football-data": {
      "url": "https://gateway.pipeworx.io/football-data/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_competition_standings