# Osyanne Osu MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.osyanne%2Fosu-mcp
Registry id: `mcp-registry/io.github.osyanne/osu-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "osyanne-osu-mcp-server": {
      "command": "uvx",
      "args": [
        "osu-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add osyanne-osu-mcp-server -- uvx osu-mcp
```

## Tools (12)

- `compare_users`: Side-by-side comparison of 2-5 users
- `get_beatmap_details`: Full attributes of a beatmap (AR/OD/CS/HP, BPM, max combo)
- `get_beatmap_scores`: Top scores on a beatmap, filterable by mods
- `get_beatmapset`: Full beatmapset with all difficulties
- `get_country_top`: Top N players of a country in pp ranking
- `get_news_posts`: Recent osu! news posts
- `get_rankings`: pp/score/charts rankings, global or by country
- `get_score_details`: Full attributes of a specific score
- `get_seasonal_backgrounds`: Active seasonal backgrounds
- `get_user_scores`: List a user's best/recent/firsts scores
- `get_user_summary`: Profile + stats; optionally embed recent/best/firsts scores
- `search_beatmaps`: Search beatmapsets with filters (mode, status, difficulty, length, BPM)

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
