English Français العربية

Ball Ranks Fantasy Sports

Official registry Games, sports and entertainment

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

Source code Website Documentation

What can you do with Ball Ranks Fantasy Sports?

  • get_week_rankings
  • get_season_rankings
  • get_player_rankings
  • get_player_projections

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http ball-ranks-fantasy-sports 'https://ballranks.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ball-ranks-fantasy-sports": {
            "type": "http",
            "url": "https://ballranks.com/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Ball Ranks plugin
  2. Server
  3. Install
  4. Current tools
  5. Review material
  6. Build the OpenAI submission ZIP
  7. Support
  8. License

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

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:

/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.

Frequently asked questions

What is Ball Ranks Fantasy Sports?

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

How do I install Ball Ranks Fantasy Sports?

It runs as a remote server. In Claude Code: claude mcp add --transport http ball-ranks-fantasy-sports 'https://ballranks.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Ball Ranks Fantasy Sports need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Ball Ranks Fantasy Sports open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Ball Ranks Fantasy Sports?

It is published by Ollynov. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.