osu! MCP

About osu! MCP

Use osu! MCP with your agent

claude mcp add osu-mcp -- uvx osu-mcp

{
  "mcpServers": {
    "osu-mcp": {
      "command": "uvx",
      "args": [
        "osu-mcp"
      ]
    }
  }
}

Frequently asked questions

What is osu! MCP?

osu! MCP is an MCP (Model Context Protocol) server by osyanne in the Search category. MCP server exposing the osu! API v2: player stats, scores, beatmap search, rankings.

How do I connect osu! MCP to Claude, Cursor, or another MCP client?

Install osu! MCP from its pypi package (osu-mcp) and register it under "mcpServers" in your client's MCP configuration — for example claude_desktop_config.json or Cursor's mcp.json — then restart the client.

Is osu! MCP open source?

Yes — the source code is public at github.com/osyanne/osu-mcp.

Can AI agents pay to use osu! MCP?

Not yet through Loomal — osu! MCP is listed as a free directory entry. If its maintainer verifies ownership, they can set per-call USDC pricing that agents pay over x402, with settlement on Base.