osu! MCP runs on your own machine — the client starts it, so there is no endpoint to ping. 100 installs a week from pypi. Last commit 24 May 2026.
MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.
Nothing serious here today
Today is the operative word: we check osu! MCP every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add osu-mcp -e 'OSU_CLIENT_ID=<OSU_CLIENT_ID>' -e 'OSU_CLIENT_SECRET=<OSU_CLIENT_SECRET>' -- uvx osu-mcp{
"mcpServers": {
"osu-mcp": {
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<OSU_CLIENT_SECRET>"
}
}
}
}[mcp_servers.osu-mcp]
command = "uvx"
args = ["osu-mcp"]
env = { OSU_CLIENT_ID = "<OSU_CLIENT_ID>", OSU_CLIENT_SECRET = "<OSU_CLIENT_SECRET>" }{
"mcpServers": {
"osu-mcp": {
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<OSU_CLIENT_SECRET>"
}
}
}
}{
"servers": {
"osu-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"osu-mcp"
],
"env": {
"OSU_CLIENT_ID": "<OSU_CLIENT_ID>",
"OSU_CLIENT_SECRET": "<OSU_CLIENT_SECRET>"
}
}
}
}Put your own values in place of
<OSU_CLIENT_ID> (Numeric Client ID from your osu! OAuth application (https://osu.ppy.sh/home/account/edit)), <OSU_CLIENT_SECRET> (Client Secret from the same osu! OAuth application).
The author’s registry entry marks them as required.
Alternatives to osu! MCP
same job, measured the same wayMCP server exposing Exa websearch API
MCP server exposing the ATimeLogger REST API (activities, reports, types)
Use this MCP server to the NHL. Team and player stats, standings, schedules, and game results....
MCP server exposing Z3 solver API
MCP server exposing the TCGdex Pokémon TCG API to LLM tools
MMA MCP: UFC, PFL, BKFC, RIZIN, OKTAGON results, stats, rankings, scorecards. Free plan, no card.
MCP server exposing the Alibre Design CAD API: parts, sketches, features, parameters.
MCP server exposing a simple Hacker News search tool (top stories).
osu! MCP — questions
Answers built from our own checks of this server.