Osu! MCP Server

MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.

Local serverstdio

What is the Osu! MCP Server?

Osu! MCP is an MCP integration. MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.

Packages and local setup

The published pypi package is osu-mcp, version 0.1.4. Its declared MCP transport is stdio.

The package declares OSU_CLIENT_ID (required): Numeric Client ID from your osu! OAuth application (https://osu.ppy.sh/home/account/edit).; OSU_CLIENT_SECRET (required): Client Secret from the same osu! OAuth application..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 0.1.4 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related other integrations MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
OSU_CLIENT_IDNumeric Client ID from your osu! OAuth application (https://osu.ppy.sh/home/account/edit).Yes
OSU_CLIENT_SECRETClient Secret from the same osu! OAuth application.Yes