Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Osu! with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Access Osu! player profiles, beatmap data, scores, and community discussions directly through your AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 13 capabilities

The complete Osu! capability set.

These are the exact actions your AI can choose when you ask it to work with Osu!.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 13 available through Osu!.

  1. 01

    Get beatmap pack

    Get a specific beatmap pack

  2. 02

    Get beatmap scores

    Get scores for a beatmap

  3. 03

    Get beatmapset

    Get a beatmapset

  4. 04

    Lookup beatmap

    Lookup a beatmap

Capability set02 / 04

05-07

3 capabilities in this set.

Part of 13 available through Osu!.

  1. 05

    List discussion votes

    Get beatmapset discussion votes

  2. 06

    List discussions

    Get beatmapset discussions

  3. 07

    Search beatmapsets

    Search beatmapsets

Capability set03 / 04

08-10

3 capabilities in this set.

Part of 13 available through Osu!.

  1. 08

    List discussion posts

    Get beatmapset discussion posts

  2. 09

    Get beatmap attributes

    Get beatmap attributes

  3. 10

    Get favourites

    Get user beatmapset favourites

Capability set04 / 04

11-13

3 capabilities in this set.

Part of 13 available through Osu!.

  1. 11

    Get me

    Requires identify scope. Get own user data

  2. 12

    Get user beatmap score

    Get a user's score on a beatmap

  3. 13

    List beatmap packs

    Get beatmap packs

Observed, not estimated

890ms average. Fast in production.

Osu! is checked daily against the live service.

Daily averagePeak 1118ms
Aug 20Today
Fastest day
743ms
Slowest day
1118ms
14-day trend
Slowing+8%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 13 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Osu!, so you can see the experience inside your AI.

It does not authenticate your account with Osu!. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Osu! Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Osu! capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "osu-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Osu! owners ask.

  • 01

    Can I calculate the difficulty of a beatmap with specific mods like DoubleTime or HardRock?

    Yes! Use the get_beatmap_attributes capability. You can provide the Beatmap ID and an array of mods to get the adjusted difficulty metrics like Star Rating, AR, and OD.

  • 02

    How do I find my own profile statistics?

    Simply run the get_me capability. It will return your public profile data, including your global rank, PP, and accuracy for your primary ruleset.

  • 03

    Is it possible to search for new beatmapsets by a specific artist?

    Yes, use the search_beatmapsets capability with a query string. For example, searching for 'Camellia' will return all relevant beatmapsets associated with that artist.

Explore

More in Audio Music

Suggestions