DXRatingMCP
Markdown

DXRating MCP Server

maimai DX for your AI assistant.Connect this server and Claude, ChatGPT, Cursor, VS Code, Cherry Studio and other AI apps can look up songs and charts from DXRating (dxrating.net) by any name or alias, read their internal levels (譜面定数) on the JP, international, USA and CN servers, and work out ratings and Best 50.

MCP (Model Context Protocol) is the standard way AI apps connect to outside tools.

Server URL

https://mcp.dxrating.net/mcp
Transport
Streamable HTTP (not SSE)
Authentication
None. If your app asks, choose "No authentication" or "No sign in".
Suggested name
dxrating

Use the URL exactly as shown, ending in /mcp. This page (https://mcp.dxrating.net/) is the guide, not the server.

One click

Add to ClaudeAdd to CursorAdd to VS CodeAdd to Cherry Studio

These open your app with the server filled in. You still review and confirm.

Let your agent set it up

Paste this into Claude Code, Codex, Cursor or another coding agent:

Add the DXRating MCP server to this agent: URL https://mcp.dxrating.net/mcp, transport Streamable HTTP, no authentication. Follow the steps for this client in https://mcp.dxrating.net/llms.txt, add it at user (global) scope, then list its tools to confirm it works.

Install

Claude claude.ai, Claude Desktop, Claude mobile

  1. Open Add to Claude, or go to Customize → Connectors → + Add → Add custom connector.
  2. Name: DXRating. Remote MCP server URL: https://mcp.dxrating.net/mcp. Click Continue.
  3. Under Authentication choose No sign in, then Add.
  4. In a chat, click + → Connectors and turn on DXRating.

The Free plan allows one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors, then members click Connect. The mobile apps can't add connectors; add it on the web or desktop and it syncs.

Docs support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp

ChatGPT web

  1. Go to https://chatgpt.com/plugins, click +, then Add custom MCP server.
  2. Name DXRating, Server URL https://mcp.dxrating.net/mcp.
  3. Authentication: No authentication. Read the warning, click I understand and want to continue, then Create as a plugin.
  4. Install the plugin. In a chat, type @ and choose DXRating.

Availability depends on your plan and workspace settings.

Docs developers.openai.com/api/docs/guides/custom-mcp-server

Cherry Studio

One click: Add to Cherry Studio. The server arrives switched off: review it, then turn it on. By hand: Settings → MCP → MCP Servers → Add → Import from JSON, and paste:

JSON
{  "mcpServers": {    "dxrating": {      "type": "streamableHttp",      "url": "https://mcp.dxrating.net/mcp"    }  }}

Keep "type": "streamableHttp". Without it Cherry Studio uses the old SSE transport, and the connection fails.

Docs docs.cherryai.com.cn/advanced-basic/extensions/mcp

Claude Code

Terminal
claude mcp add --transport http --scope user dxrating https://mcp.dxrating.net/mcp

Check with claude mcp list or /mcp. In a project .mcp.json, keep "type": "http":

.mcp.json
{  "mcpServers": {    "dxrating": {      "type": "http",      "url": "https://mcp.dxrating.net/mcp"    }  }}

Docs code.claude.com/docs/en/mcp

Cursor

Add to Cursor, or add this to ~/.cursor/mcp.json:

~/.cursor/mcp.json
{  "mcpServers": {    "dxrating": {      "url": "https://mcp.dxrating.net/mcp"    }  }}

Docs cursor.com/docs/mcp

VS Code GitHub Copilot

Add to VS Code, or run:

Terminal
code --add-mcp '{"name":"dxrating","type":"http","url":"https://mcp.dxrating.net/mcp"}'

.vscode/mcp.json and the user-profile mcp.json use servers, not mcpServers:

.vscode/mcp.json
{  "servers": {    "dxrating": {      "type": "http",      "url": "https://mcp.dxrating.net/mcp"    }  }}

Docs code.visualstudio.com/docs/agent-customization/mcp-servers

Codex CLI, IDE extension, ChatGPT desktop app

Terminal
codex mcp add dxrating --url https://mcp.dxrating.net/mcp

Or add to ~/.codex/config.toml, which the IDE extension and the ChatGPT desktop app share:

~/.codex/config.toml
[mcp_servers.dxrating]url = "https://mcp.dxrating.net/mcp"

Docs learn.chatgpt.com/docs/extend/mcp

Gemini CLI

Terminal
gemini mcp add --transport http -s user dxrating https://mcp.dxrating.net/mcp

Or in ~/.gemini/settings.json use httpUrl (in Gemini, url means the old SSE transport):

~/.gemini/settings.json
{  "mcpServers": {    "dxrating": {      "httpUrl": "https://mcp.dxrating.net/mcp"    }  }}

Docs geminicli.com/docs/tools/mcp-server/

Other apps

Add a remote MCP server with the URL, Streamable HTTP and no authentication. Most apps (Trae, Kiro, LM Studio, Windsurf, the JetBrains AI Assistant) take this JSON:

JSON
{  "mcpServers": {    "dxrating": {      "url": "https://mcp.dxrating.net/mcp"    }  }}

Apps that only run local (stdio) servers can reach it through mcp-remote (needs Node.js):

JSON
{  "mcpServers": {    "dxrating": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://mcp.dxrating.net/mcp",        "--transport",        "http-only"      ]    }  }}

Try it

Ask in any language: English, 日本語, 简体中文, 繁體中文. Titles, aliases and nicknames all work.

  • Which song is "bbb"? List its charts with their levels.

  • What is the internal level of PANDORA PARADOXXX's Re:MASTER on the JP, international and CN servers?

  • Which charts of level 14 have the lowest internal level on the international server?

  • What rating does 100.5% on the master chart of 系ぎて give, and what do I need for 300?

  • Here are my best scores: … What is my Best 50 rating, and which charts should I improve first?

  • Has the internal level of PANDORA PARADOXXX's master chart changed between versions?

Check that it works: ask "Using DXRating, what is the internal level of the master chart of 系ぎて?" A good answer names the server and the version, and credits DXRating. If the assistant answers without calling a tool, say "use the DXRating tools".

Tools

All tools are read-only. They read the public song catalog and cannot see or change any account.

  • search_songs

    Finds songs by title, alias, nickname, romanization or artist, with the level of each chart

  • get_sheet

    A song and its charts: internal level now and in past versions, notes, designer, servers, tags

  • calculate_rating

    The rating of an achievement on a chart, the achievement a rating needs, the rating of each rank

  • calculate_best50

    A rating from pasted scores: the new 15 and old 35, and the scores worth improving

Data and license

  • The songs, charts, aliases and tags are those of DXRating (dxrating.net), updated with each game update. Internal levels can differ by server: jp (Japan), intl (international), usa and cn. The assistant asks yours or uses jp.
  • Achievements are integers in 1/10000 of a percent, in what the tools take and return: 100.7543% is 1007543. Your assistant converts them for you.
  • Ratings follow the game: Best 50 is the 15 best charts of the current version plus the 35 best of older ones. AP and AP+ add 1 to a chart's rating.
  • License: CC BY-NC 4.0, for non-commercial use with credit: Data: DXRating (https://dxrating.net), CC BY-NC 4.0. The server asks assistants to include it.

Limits

  • 300 requests per minute per IP address. A question usually takes 1 to 4 requests.
  • Over the limit, the server answers "Too many requests. Retry in N seconds." Wait that long and retry.
  • Claude.ai and ChatGPT connect from their companies' servers, so their users may share a limit.
  • Best 50 takes up to 300 scores per request.

Privacy

  • No account, no key, no cookies. This page loads no third-party scripts and has no analytics.
  • The server only receives what your assistant sends it: the tool name and its arguments, such as a song name or the scores you pasted. It never sees your conversation, and it does not store your scores.
  • For each request we log the time, the path, the status, how long it took and the request headers, which include the IP address and the User-Agent, but not the body with the tool arguments. The logs go to our monitoring provider (Sentry) and are used only to run the service and stop abuse.
  • Requests pass through Cloudflare, which processes them under its own terms.

Troubleshooting

"Can't connect", an SSE error, or 405
the app may be using the old SSE transport, which this server does not support. Choose Streamable HTTP: "type": "streamableHttp" in Cherry Studio, httpUrl in Gemini CLI.
The app asks you to sign in
no sign-in is needed. Choose "No sign in" or "No authentication".
Opening /mcp in a browser brings you here
that's expected. The endpoint only takes POST requests from AI apps.
"still loading its song catalog"
the server restarted. Retry in a minute.
The tools are added but not used
turn the connector on in the chat and say "use DXRating".

Test without an AI: run npx @modelcontextprotocol/inspector, choose Streamable HTTP and enter the URL. Or:

Terminal
curl -s https://mcp.dxrating.net/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -H 'Mcp-Protocol-Version: 2025-06-18' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'