Skip to content

Ball Ranks

Read-only NFL and NBA fantasy rankings and player projections, including aggregate weekly rankings from 40+ leading fantasy sources.

build.protocol_tooling.mcp

Install Ball Ranks in your MCP client

Ball Ranks is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add Ball Ranks to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; Ball Ranks's tools should appear.
{
  "mcpServers": {
    "ball-ranks": {
      "command": "npx",
      "args": [
        "-y",
        "@ball-ranks/mcp-server"
      ],
      "note": "Replace with the actual package name from the server's documentation."
    }
  }
}

Install Ball Ranks in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. Ball Ranks will show up in the assistant's tool list on next launch.

Install Ball Ranks in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). Ball Ranks will show up in the assistant's tool list on next launch.

Install Ball Ranks in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). Ball Ranks will show up in the assistant's tool list on next launch.

Install Ball Ranks in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. Ball Ranks will show up in the assistant's tool list on next launch.

Tools exposed by Ball Ranks

Once installed, Ball Ranks exposes the following MCP tools to your AI assistant. Each tool can be called directly by the assistant whenever its capability is relevant to your prompt.

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

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

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

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

Transport

Ball Ranks supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

streamable-http

Other Model Context Protocol servers in the same space as Ball Ranks. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.