MCP server
osu! MCP
io.github.Osyanne/osu-mcp
Checked 26 Oct 2026, 08:31 UTC · Still published on its registry; checked against OSV.dev; never run by us
MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.
At a glance
- Type
- MCP server
- Publisher
- Not verified
- Status
- Runs on your computer
- Sets up in
- Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code
- Last checked
- 26 Oct 2026, 08:31 UTC
Connect it to your agent
Opens the app, which shows the server and asks you to confirm. It then runs the package on your computer with your permissions. For other apps, copy the setup below.
Claude Code
claude mcp add osu-mcp --env OSU_CLIENT_ID=YOUR_VALUE --env OSU_CLIENT_SECRET=YOUR_VALUE -- uvx osu-mcp@0.1.4
Claude Desktop
{"mcpServers":{"osu-mcp":{"command":"uvx","args":["osu-mcp@0.1.4"],"env":{"OSU_CLIENT_ID":"YOUR_VALUE","OSU_CLIENT_SECRET":"YOUR_VALUE"}}}}
Codex (config.toml)
[mcp_servers.osu-mcp]
command = "uvx"
args = ["osu-mcp@0.1.4"]
env = { OSU_CLIENT_ID = "YOUR_VALUE", OSU_CLIENT_SECRET = "YOUR_VALUE" }
Gemini CLI
{"mcpServers":{"osu-mcp":{"command":"uvx","args":["osu-mcp@0.1.4"],"env":{"OSU_CLIENT_ID":"YOUR_VALUE","OSU_CLIENT_SECRET":"YOUR_VALUE"}}}}
Cursor
{"mcpServers":{"osu-mcp":{"command":"uvx","args":["osu-mcp@0.1.4"],"env":{"OSU_CLIENT_ID":"YOUR_VALUE","OSU_CLIENT_SECRET":"YOUR_VALUE"}}}}
VS Code
{"servers":{"osu-mcp":{"type":"stdio","command":"uvx","args":["osu-mcp@0.1.4"],"env":{"OSU_CLIENT_ID":"YOUR_VALUE","OSU_CLIENT_SECRET":"YOUR_VALUE"}}}}
Runs on your computer with your permissions: check the package and its source before installing. Replace YOUR_VALUE with your own OSU_CLIENT_ID, OSU_CLIENT_SECRET.
Browse
Related MCP servers
- College Baseball
Live NCAA DI college baseball scores, standings, schedules, rankings, and sabermetrics. - Livetennisapi
Live tennis scores, players, rankings, odds and win-probability. ATP, WTA, Challenger, ITF, juniors. - Nba
NBA MCP — player, team, and game data via the BallDontLie API - Agent Arcade
Create, test and play AI-native games through server-authoritative contracts. - Opendota
OpenDota MCP — Dota 2 open stats. - Not Human Search
Search the agentic web. 4,100+ sites, 11 tools incl. check_url + verify_mcp for probe-before-use. - Balldontlie
balldontlie.io MCP. - DraftCall
Should I start X or Y? NFL fantasy compares, rankings, byes, matchups, schedule strength, checks
Badge for your README
[](https://aptlynx.net/servers/io.github.Osyanne/osu-mcp)
Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents