Osu! MCP
Let your coding agent query osu! API v2 for player stats, scores, beatmap search, and rankings while you build community or analytics side projects.
Overview
osu! MCP is a MCP server for the Build phase that exposes osu! API v2 player stats, scores, beatmap search, and rankings to your coding agent.
What is this MCP server?
- Exposes osu! API v2: player stats, scores, beatmap search, and rankings via MCP tools
- stdio transport with PyPI package osu-mcp at version 0.1.4
- Requires osu! OAuth Client ID and Client Secret from osu.ppy.sh account settings
- Useful for leaderboard bots, profile dashboards, and beatmap discovery assistants
- Server schema version 0.1.4 on PyPI identifier osu-mcp
- stdio transport with two required OAuth environment variables
What problem does it solve?
Agents cannot query osu! leaderboards and profiles unless you paste API docs and wire OAuth yourself on every task.
Who is it for?
Indie devs building osu! bots, stats sites, or agent workflows that need live ranking and beatmap data.
Skip if: Teams with no osu! use case or builders who need generic REST without game-specific OAuth setup.
What do I get? / Deliverables
After install, your agent can call typed MCP tools against osu! v2 using your OAuth app credentials.
- Agent-callable tools for osu! player and score endpoints
- Beatmap search and ranking queries without custom HTTP glue
- Repeatable osu! API workflows in local dev sessions
Recommended MCP Servers
Journey fit
Third-party game API wiring belongs on the Build shelf under integrations once you are implementing features, not during pure ideation. OAuth-backed osu! v2 calls are classic external-service integration work for agents and small apps.
How it compares
Game API MCP integration, not a reusable agent skill or local database.
Common Questions / FAQ
Who is Osu! MCP for?
Solo builders and small teams creating osu!-related tools who want their agent to read official API v2 data during development.
When should I use Osu! MCP?
Use it in the Build integrations subphase when you are implementing features that need player stats, scores, beatmaps, or rankings from osu!.
How do I add Osu! MCP to my agent?
Install the osu-mcp PyPI package, set OSU_CLIENT_ID and OSU_CLIENT_SECRET from your osu! OAuth app, and register the stdio server in Claude Code or Cursor MCP config.