• RANKING
  • SCORES
  • PROFILE
  • HUMAN

How to track osu! player stats and rankings with your AI

Connect once, then ask your agent for any stat you need. It pulls live data from your osu! account directly into your chat.

Ask AI about this page

Short answer

How can I track my osu! stats with an AI?

You can ask your agent for your current global rank, total PP, or accuracy on specific beatmaps. It fetches this data from osu! and presents it in your chat window. You'll see exactly how your performance breaks down below.

The results you get

Where your data lands

Your AI pulls specific metrics from the osu! API and brings them to your conversation.

RANKING

Live global rank

The AI pulls your current standing and PP. You'll get your latest ranking without leaving your chat client.

SCORES

Beatmap performance

Ask about specific maps to see your accuracy and score. The AI retrieves these individual play details for you.

PROFILE

User account overview

Get a snapshot of any user's profile. The AI pulls account-level data to give you a quick summary.

HUMAN

Manual gameplay

The AI only reads your stats. You still have to play the maps and hit the notes to change your rank.

The workflow

What your AI does when you ask for stats.

The AI acts as a bridge between your chat and the osu! database.

  1. Identify user

    The AI finds your specific account details to ensure the data is accurate.

    get_me

  2. Fetch profile data

    It pulls your global rank and performance points from the osu! servers.

    get_me

  3. Look up scores

    When you ask about a specific map, the AI finds that exact play in your history.

    get_user_beatmap_score

  4. Summarize stats

    The AI takes the raw numbers and turns them into a clear answer in your chat.

    get_meget_user_beatmap_score

Try it

Copy these to start.

Paste these directly into your chat to begin.

Starting points

Swap out the bracketed text with your actual osu! username or map names.

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"
    }
  }
}
Copy into chat04

  • What is my current global rank and PP?

  • Show me my score for the beatmap [map name] by [artist].

  • Check the stats for user [username].

  • How was my accuracy on my last played map?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Osu! once, then ask.

One click connects the MCP to your agent. Your login stays encrypted on our side, and you can start asking for stats immediately.

Connect Osu! to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my osu! rank?

    No. The AI can only read your data. It cannot play maps or change your account information.

  • 02

    Can I use this to find other players' stats?

    Yes, as long as the user's profile is public and the tool can access it.

  • 03

    Does the AI store my osu! password?

    No. Your credentials are encrypted and managed securely by Vinkius.

  • 04

    Can the AI submit new scores for me?

    No. The tools only allow for retrieving existing data, not submitting new scores.

  • 05

    Will this work in any AI client?

    It works in any client that supports the Model Context Protocol (MCP).

  • More questions about Osu!? The Connector page answers them. See everything the Osu! Connector can do

Connect Osu! to Claude, Cursor, ChatGPT & more