Ball Ranks Plugin MCP Server

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:

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