osu! MCP
Rank #61,912io.github.Osyanne/osu-mcp
MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.
osu! MCP is a Model Context Protocol (MCP) server published by osyanne. It ranks #61,912 of 132,405 servers tracked on MCP Toplist. osu! MCP is listed across 3 registries — Official MCP, Glama and PulseMCP, with 1 tracked version. It was first listed on May 23, 2026 and most recently updated on May 23, 2026.
Ranks ahead of 70,493 of 132,405 servers on MCP Toplist.
Use osu! MCP
Requires user-supplied configuration before first use — typically an API key, token or connection string set via environment variables.
claude mcp add osu-mcp -e "OSU_CLIENT_ID=<your OSU_CLIENT_ID>" -e "OSU_CLIENT_SECRET=<your OSU_CLIENT_SECRET>" -- uvx osu-mcpReplace each placeholder with your own value before saving.
[mcp_servers.osu-mcp]
command = "uvx"
args = ["osu-mcp"]
[mcp_servers.osu-mcp.env]
OSU_CLIENT_ID = "<your OSU_CLIENT_ID>"
OSU_CLIENT_SECRET = "<your OSU_CLIENT_SECRET>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"osu-mcp": {
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<your OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<your OSU_CLIENT_SECRET>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"osu-mcp": {
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<your OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<your OSU_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"osu-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<your OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<your OSU_CLIENT_SECRET>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"osu-mcp": {
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<your OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<your OSU_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"osu-mcp": {
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<your OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<your OSU_CLIENT_SECRET>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.Osyanne%2Fosu-mcp)<a href="https://mcptoplist.com/server/io.github.Osyanne%2Fosu-mcp"><img src="https://mcptoplist.com/badge/io.github.Osyanne%2Fosu-mcp.svg" alt="MCP Toplist: Top 50% of 132,405" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 3 registries
osyanne
Other servers by osyanne
View all osyanne servers →Available versions (1)
| Version | Published |
|---|---|
| 0.1.4 | May 23, 2026 |
Frequently asked questions
- Who maintains osu! MCP?
- osu! MCP is maintained by osyanne, which publishes 2 MCP servers (1 total version) tracked on MCP Toplist.
- Is osu! MCP listed on the Official MCP Registry?
- Yes — osu! MCP is listed on the Official MCP Registry, alongside Glama and PulseMCP.
- How many versions does osu! MCP have?
- MCP Toplist tracks 1 version of osu! MCP, most recently published on May 23, 2026.
- Where can I find the source code for osu! MCP?
- The source code for osu! MCP is hosted at github.com/osyanne/osu-mcp.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.