`predictions`

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

API-Football’s own match-outcome predictions. Returns home/draw/away win probabilities, advice, h2h context, form. Use for “who will win” research on specific fixtures.

Parameters

Name	Type	Required	Description
`fixture`	number	yes	Fixture ID — get from fixtures() output
`_apiKey`	string	no

Example call

Arguments

{
  "fixture": 1234567,
  "_apiKey": "your-api-football-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/api-football/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"predictions","arguments":{"fixture":1234567,"_apiKey":"your-api-football-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('predictions', {
  "fixture": 1234567,
  "_apiKey": "your-api-football-api-key"
});

Response shape

Full JSON Schema

{
  "oneOf": [
    {
      "type": "null",
      "description": "No prediction data found for fixture"
    },
    {
      "type": "object",
      "description": "Match prediction object with outcome probabilities and analysis"
    }
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

predictions