Osu! Connector for AI agents.
13 live capabilities
Query player stats, beatmap data, and community rankings in real time.
Waiting for input…
Why people use Osu!
Osu! for Ending Manual Beatmap Data Searches
With the Osu! MCP, you just ask your agent. It pulls the data directly. You get a clean summary of your rank, a list of scores, or a digest of community feedback in one place.
What Vinkius changes
You get direct API access to Osu! data through a simple chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Checking personal bests
A player wants to see their score on a specific map.
- Real-world use case 02
Mapping feedback
A mapper wants to see why a map is getting downvotes.
- Real-world use case 03
Difficulty checking
A player wants to know how hard a map is with DoubleTime.
Complete set · 13capabilities
The complete Osu! capability set.
These are the exact actions your AI can choose when you ask it to work with Osu!.
01—04
4 capabilities in this set.
Part of 13 available through Osu!.
- 01 Capability
Get beatmap pack
Retrieves a specific beatmap pack. Use this when you need to grab a whole collection at once.
- 02 Capability
List beatmap packs
Shows all available beatmap packs. This is great for browsing curated content.
- 03 Capability
Get beatmap scores
Gets the scores for a specific beatmap. It lets you see how others performed on a map.
- 04 Capability
Get beatmapset
Pulls information for a specific beatmapset. Use this to get the core details of a map collection.
05—07
3 capabilities in this set.
Part of 13 available through Osu!.
- 05 Capability
List discussion votes
Shows the votes for a beatmapset discussion. It helps you see what the community likes.
- 06 Capability
List discussions
Pulls the discussion threads for a beatmapset. This lets you see what people are actually saying.
- 07 Capability
Get favourites
Retrieves the beatmapset favorites for a user. Use this to see what a specific player likes.
08—10
3 capabilities in this set.
Part of 13 available through Osu!.
- 08 Capability
Lookup beatmap
Finds a specific beatmap based on its ID. It's the quickest way to get data on a single map.
- 09 Capability
Get user beatmap score
Pulls a specific user's score on a map. This is perfect for checking your own personal bests.
- 10 Capability
Get beatmap attributes
Pulls specific details about a beatmap. It helps you see the underlying data for any map.
11—13
3 capabilities in this set.
Part of 13 available through Osu!.
- 11 Capability
Get me
Pulls the authenticated user's data. This is how your agent knows who you are.
- 12 Capability
Search beatmapsets
Searches for beatmapsets across the game. Use this to find new content quickly.
- 13 Capability
List discussion posts
Lists all posts within a beatmapset discussion. This helps you read through the whole community thread.
Set up in minutes
One URL. Then ask Osu! to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Osu! from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Osu!, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Osu! for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Osu! URL.
- Step 03
Save and start
Save the connection and enable Osu! in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"osu": {
"url": "https://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Osu!
Open Agent mode in chat and ask: "Using Osu!, help me...". 13 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"osu": {
"url": "https://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Osu!
Ask Copilot: "Using Osu!, help me...". 13 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"osu": {
"url": "https://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Osu!
Open Cascade and ask: "Using Osu!, help me...". 13 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"osu": {
"url": "https://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Osu!
Ask Cline: "Using Osu!, help me...". 13 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add osu --transport http "https://edge.vinkius.com/vk_preview_idbAvUACFPzs9KS850RTtZmf4Xh5bSzXK57yhZpw/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Osu!
Ask Claude: "Using Osu!, show me...". 13 tools are ready
Where the request belongs
Work Osu! can move forward.
For the rhythm game obsessed. It's for the players tracking their progress, the mappers managing community feedback, and the data nerds who want to see the numbers behind the music.
Competitive Player
Checks rank and compares scores against top players during a session.
Beatmap Mapper
Monitors discussion votes and community feedback on their latest work.
Data Analyst
Pulls beatmap attributes and scoring data to study game trends.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsB5 Arena
Automate Counter-Strike intelligence via B5 Arena. scan matchmaking leaderboards, track player ELO, and fetch competitive match logs natively from any AI agent.
Brawl Stars
Access real-time Brawl Stars data. track player stats, battle logs, club rankings, and event rotations directly from your AI agent.
5E Arena
Automate competitive CS2 tracking via 5E Arena. fetch deep matchmaking stats, global leaderboards, and player performance scores natively from any AI agent.
Apex Legends
Track Apex Legends player stats, match history, leaderboards, and server status directly from your AI agent.
Steam Performance & Scouting Intelligence
The definitive server for professional Steam scouting. analyze player performance, achievements, and technical game stats via AI.
FanPower (PickUp)
Drive fan engagement via FanPower (PickUp). manage interactive questions, track fan picks, and monitor rewards directly through your AI agent.
Bring your own AI
Change the model, client or framework. Keep Osu! connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Osu!.
The practical details behind the request, access and result.
Can the Osu! MCP show my personal ranking?
Yes, it pulls your public stats from the Osu! API so your agent can tell you your current rank, PP, and accuracy instantly.
Can I use Osu! MCP to see community feedback?
Yes, it can pull discussion threads and votes for specific beatmapsets, allowing you to see what the community thinks of a map.
Does Osu! MCP work with Cursor?
Yes, it works with any MCP-compatible client, including Cursor, Claude, and Windsurf.
Can I check scores for specific maps?
Yes, you can ask your agent to fetch the top leaderboard scores for any beatmap ID.
Can Osu! MCP find beatmap packs?
Yes, it can list available beatmap packs and retrieve specific ones for you to explore.
How do I get my own data with Osu! MCP?
Once connected, your agent can use the get_me capability to pull your specific profile data using your personal access token.
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.
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.
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.
One connection away
Give your agent a direct line to Osu!.
Connect Osu! once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available