DXRating MCP Server

maimai DX songs, internal levels and ratings, right in Claude, ChatGPT, Cursor and other AI apps.

FreeNo accountNo API keyRead-only

Server URL

https://mcp.dxrating.net/mcp?via=dxrating-developers.guide

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?via=dxrating-developers.guide. 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?via=dxrating-developers.guide.
  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

Claude Code

Terminal
claude mcp add --transport http --scope user dxrating 'https://mcp.dxrating.net/mcp?via=dxrating-developers.guide'

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?via=dxrating-developers.guide"    }  }}

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?via=dxrating-developers.guide"    }  }}

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?via=dxrating-developers.guide"}'

.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?via=dxrating-developers.guide"    }  }}

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?via=dxrating-developers.guide'

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?via=dxrating-developers.guide"

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

Other apps

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?via=dxrating-developers.guide"    }  }}

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

Gemini CLI

Terminal
gemini mcp add --transport http -s user dxrating 'https://mcp.dxrating.net/mcp?via=dxrating-developers.guide'

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?via=dxrating-developers.guide"    }  }}

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

Trae · Kiro · LM Studio · Windsurf · JetBrains AI Assistant

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?via=dxrating-developers.guide"    }  }}

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?via=dxrating-developers.guide",        "--transport",        "http-only"      ]    }  }}

What it can do

  • search_songsFinds songs by title, alias, nickname, romanization or artist, with the level of each chart
  • get_sheetA song and its charts: internal level now and in past versions, notes, designer, servers, tags
  • list_recent_songsSongs and charts released recently, by date: new songs, and new charts of older songs
  • calculate_ratingThe rating of an achievement on a chart, the achievement a rating needs, the rating of each rank
  • calculate_best50A rating from pasted scores: the new 15 and old 35, and the scores worth improving
Advanced
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.

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?via=dxrating-developers.guide, transport Streamable HTTP, no authentication. Follow the steps for this client in https://mcp.dxrating.net/llms.txt?via=dxrating-developers, add it at user (global) scope, then list its tools to confirm it works.

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?via=dxrating-developers.guide' -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"}'