Ball Ranks Fantasy Sports

Working · 1.4 s

io.github.Ollynov/ball-ranksv1.1.2

Fantasy football and basketball rankings and player projections from Ball Ranks.

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://ballranks.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_player_projections Read-only

Look up one player's published season projection, or a weekly football projection, by player ID or slug. Weekly projections require scope=weekly and a week number.

sportstring, required

playerstring, required

weekinteger

modelstring

scopestring

seasonstring

scoring_formatstring

Tools (4)

get_player_projections

Look up one player's published season projection, or a weekly football projection, by player ID or slug. Weekly projections require scope=weekly and a week number.

read-only

Argument	Type	Description
week	integer
model	string
scope	string
sport*	string
player*	string
season	any
scoring_format	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sport",
    "player"
  ],
  "properties": {
    "week": {
      "type": "integer",
      "maximum": 18,
      "minimum": 1
    },
    "model": {
      "enum": [
        "v0",
        "v1"
      ],
      "type": "string",
      "default": "v0"
    },
    "scope": {
      "enum": [
        "season",
        "weekly"
      ],
      "type": "string",
      "default": "season"
    },
    "sport": {
      "enum": [
        "basketball",
        "football"
      ],
      "type": "string"
    },
    "player": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": -9007199254740991
        }
      ]
    },
    "scoring_format": {
      "enum": [
        "standard",
        "half_ppr",
        "ppr"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_player_rankings

Look up one player's published Ball Ranks season ranking by player ID or slug. Use this when the user asks where a specific player ranks.

read-only

Argument	Type	Description
model	string
sport*	string
player*	string
season	any
scoring_format	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sport",
    "player"
  ],
  "properties": {
    "model": {
      "enum": [
        "v0",
        "v1"
      ],
      "type": "string",
      "default": "v0"
    },
    "sport": {
      "enum": [
        "basketball",
        "football"
      ],
      "type": "string"
    },
    "player": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": -9007199254740991
        }
      ]
    },
    "scoring_format": {
      "enum": [
        "standard",
        "half_ppr",
        "ppr"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_season_rankings

Return a paginated Ball Ranks season ranking board for fantasy basketball or football. Basketball uses nine-category per-game rankings; football accepts standard, half-PPR, or PPR scoring.

read-only

Argument	Type	Description
limit	integer
model	string
sport*	string
offset	integer
season	any
scoring_format	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sport"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "model": {
      "enum": [
        "v0",
        "v1"
      ],
      "type": "string",
      "default": "v0"
    },
    "sport": {
      "enum": [
        "basketball",
        "football"
      ],
      "type": "string"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 10000,
      "minimum": 0
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": -9007199254740991
        }
      ]
    },
    "scoring_format": {
      "enum": [
        "standard",
        "half_ppr",
        "ppr"
      ],
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_week_rankings

Return published weekly fantasy football rankings for one position, week, and scoring format. Use this for start/sit comparisons or a ranked position list. This tool does not support basketball.

read-only

Argument	Type	Description
week*	integer
limit	integer
model	string
sport	string
offset	integer
season	any
position	string
scoring_format	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "week"
  ],
  "properties": {
    "week": {
      "type": "integer",
      "maximum": 18,
      "minimum": 1
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "model": {
      "enum": [
        "v0",
        "v1"
      ],
      "type": "string",
      "default": "v0"
    },
    "sport": {
      "enum": [
        "basketball",
        "football"
      ],
      "type": "string",
      "default": "football"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 10000,
      "minimum": 0
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 32,
          "minLength": 1
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": -9007199254740991
        }
      ]
    },
    "position": {
      "enum": [
        "QB",
        "RB",
        "WR",
        "TE",
        "K",
        "DST"
      ],
      "type": "string",
      "default": "RB"
    },
    "scoring_format": {
      "enum": [
        "standard",
        "half_ppr",
        "ppr"
      ],
      "type": "string",
      "default": "ppr"
    }
  },
  "additionalProperties": false
}