Ball Ranks

Official4 tools

by Ollynov · Python

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

io.github.Ollynov/ball-ranks (MCP Server)

The MCP server “io.github.Ollynov/ball-ranks” provides fantasy football and basketball rankings and player projections from Ball Ranks. Its purpose is to surface Ball Ranks–sourced ranking and projection data for use by connected clients in an MCP-enabled workflow.

🛠️ Key Features

Fantasy football rankings
Fantasy basketball rankings
Player projections from Ball Ranks

🚀 Use Cases

Retrieve rankings for fantasy football players
Retrieve rankings for fantasy basketball players
Access projected player outputs based on Ball Ranks data

⚡ Developer Benefits

Consistent MCP server integration for Ball Ranks ranking/projection data
Allows clients to consume rankings and projections in a structured way

⚠️ Limitations

Only described for Ball Ranks rankings and player projections (no other data sources or tools are specified)

Topics

agent-pluginsfantasy-basketballfantasy-footballgemini-cli-extensionmcp

Captured live from the server via tools/list.

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.

Parameters8

sport	string	optional
season	any	optional
week	integer	required
position	string	optional
scoring_format	string	optional
model	string	optional
limit	integer	optional
offset	integer	optional

Raw schema

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

Parameters6

sport	string	required
season	any	optional
scoring_format	string	optional
model	string	optional
limit	integer	optional
offset	integer	optional

Raw schema

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

Parameters5

sport	string	required
player	string	required
season	any	optional
scoring_format	string	optional
model	string	optional

Raw schema

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

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.

Parameters7

sport	string	required
player	string	required
scope	string	optional
season	any	optional
week	integer	optional
scoring_format	string	optional
model	string	optional

Raw schema

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

README.md5 KBView on GitHub

Ball Ranks plugin

Ball Ranks provides published fantasy basketball and football rankings and player projections through a read-only remote MCP server.

This repository packages the same live server for ChatGPT and Codex, Claude, Google Antigravity, Gemini CLI, Grok Build, Muse Code, and other Agent Plugins or MCP-compatible clients. The initial MCP surface contains four tools; clients discover the live tool list so Ball Ranks can add capabilities without changing the server URL.

Server

MCP endpoint: https://ballranks.com/api/mcp
Developer documentation: https://ballranks.com/developers
OpenAPI: https://ballranks.com/openapi.json
Support: https://ballranks.com/support
Privacy: https://ballranks.com/privacy
Terms: https://ballranks.com/terms

Install

Clients that support Agent Plugins can install this repository directly. Platform-native manifests are also included:

plugin.json and mcp.json: Agent Plugins, ChatGPT, and Codex
server.json: Official MCP Registry
.codex-plugin/plugin.json: Codex local plugin compatibility
.claude-plugin/plugin.json and .mcp.json: Claude Code and Grok Build
antigravity-plugin/: Google Antigravity 2.0, CLI, and IDE
gemini-extension.json and GEMINI.md: enterprise and paid API-key Gemini CLI installations

No API keys are stored in this repository. Anonymous Model Zero access works with lower request limits. Ball Ranks API keys can be created at https://ballranks.com/account#developer-access for account-level limits; clients must store credentials securely.

Google Antigravity

Google moved unpaid and Google One Gemini CLI users to Antigravity CLI on June 18, 2026. Clone this repository, then install the native package from its dedicated directory:

agy plugin install ./antigravity-plugin

Inside the Antigravity CLI, the equivalent command is:

text

/plugin install ./antigravity-plugin

The package installs as ball-ranks, connects to the production MCP endpoint through serverUrl, and includes a focused Ball Ranks skill. Run agy plugin list and open /mcp to verify that the plugin and server loaded.

For a workspace-only Antigravity 2.0 or IDE installation, copy the package directory to .agents/plugins/ball-ranks/. For a global installation, copy it to ~/.gemini/config/plugins/ball-ranks/.

Marketplace publication is separate from the package. Google currently asks publishers to complete its Antigravity Marketplace interest form.

Gemini CLI (enterprise and API-key installations)

Install directly from the public repository:

gemini extensions install https://github.com/Ollynov/ball-ranks-plugin

Restart Gemini CLI after installation, then run /extensions list and /mcp to confirm that ball-ranks and its live tools are available. GEMINI.md gives Gemini concise tool-selection and response guidance. This package remains for enterprise and paid API-key Gemini CLI installations.

The public gallery discovers repositories automatically. This repository is public, has the gemini-cli-extension GitHub topic, and keeps gemini-extension.json at the repository root. No separate gallery submission is required.

Current tools

get_week_rankings
get_season_rankings
get_player_rankings
get_player_projections

All tools are read-only and return structured content plus a canonical sourceUrl.

Review material

review/review-cases.json contains the same five positive and three negative cases imported from plugin.json. review/demo-script.md is the shared walkthrough plan. review/openai-submission.md records the remaining dashboard work and tool-annotation justifications. Run the cases against production after any tool-contract change.

Build the OpenAI submission ZIP

Run ./scripts/build-openai-submission.sh from a clean, committed checkout. The script validates the package and creates dist/ball-ranks-openai-<version>.zip from the current commit. Rebuilding the same commit produces the same SHA-256 digest.

The ZIP contains only the portable manifest, remote MCP configuration, onboarding skill, and referenced square icons. It intentionally excludes platform compatibility manifests, review notes, repository documentation, and screenshots.

Support

Email help@ballranks.com or visit https://ballranks.com/support. Never include passwords, sign-in cookies, or full API keys in a support request.

License

The packaging files and skill instructions in this repository are available under the MIT License. Ball Ranks data and services remain subject to the Ball Ranks Terms of Service.

Install

Tools (4)

get_week_rankingsget_season_rankingsget_player_rankingsget_player_projections

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://ballranks.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ball-ranks": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ballranks.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.Ollynov/ball-ranks (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_week_rankings

get_season_rankings

get_player_rankings

get_player_projections

Ball Ranks plugin

Server

Install

Google Antigravity

Gemini CLI (enterprise and API-key installations)

Current tools

Review material

Build the OpenAI submission ZIP

Support

License

Install

Remote endpoint

Related servers