1. Conduid
  2. Documentation
  3. osu! MCP
MCP server · Documentation

osu! MCP

· github.com/Osyanne/osu-mcp

Model Context Protocol server for the osu! API. OAuth 2.0 auth, automatic rate limiting, typed responses, and clean data access for LLM tool use.

Unclaimed apimcpmodel-context-protocoloauth2rate-limitingtypescript
InstallView source
37Low

Scored 6 days ago · breakdown

About osu! MCP

osu! MCP is an MCP server in the Documentation category: model Context Protocol server for the osu! API. OAuth 2.0 auth, automatic rate limiting, typed responses, and clean data access for LLM tool use.

Install

uvx
uvx osu-mcp
pip
pip install osu-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (12)

compare_usersSide-by-side comparison of 2-5 users

Parameters not published.

get_beatmap_detailsFull attributes of a beatmap (AR/OD/CS/HP, BPM, max combo)

Parameters not published.

get_beatmap_scoresTop scores on a beatmap, filterable by mods

Parameters not published.

get_beatmapsetFull beatmapset with all difficulties

Parameters not published.

get_country_topTop N players of a country in pp ranking

Parameters not published.

get_news_postsRecent osu! news posts

Parameters not published.

get_rankingspp/score/charts rankings, global or by country

Parameters not published.

get_score_detailsFull attributes of a specific score

Parameters not published.

get_seasonal_backgroundsActive seasonal backgrounds

Parameters not published.

get_user_scoresList a user's best/recent/firsts scores

Parameters not published.

get_user_summaryProfile + stats; optionally embed recent/best/firsts scores

Parameters not published.

search_beatmapsSearch beatmapsets with filters (mode, status, difficulty, length, BPM)

Parameters not published.

Ask AI

✦

Ask AI about osu! MCP

Powered by Claude · Grounded in docs

I know everything about osu! MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

6 checks have not been run yet.

Questions

About osu! MCP

How do I install osu! MCP?

Run uvx osu-mcp, then add the server to your MCP client's configuration.

Is osu! MCP safe to use with an AI agent?

Its trust score is 37 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. It has no ConduID identity yet, so agent calls to it are not receipted.

Is osu! MCP still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.