DXRating

Working

net.dxrating/dxratingv1.0.0 Domain verified

maimai DX songs, charts and internal levels, and rating and Best 50 calculators, from DXRating

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.dxrating.net/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

calculate_best50 Read-only

A maimai DX player's rating from their scores: the new 15 (b15) and old 35 (b35), with each chart's rating, and the scores whose next rank would raise the rating most. Achievements are integers in 1/10000 of a percent: 100.7543% is 1007543.

scoresarray, required

The scores of the player, up to 300; of a chart given twice the better one counts

serverstring

Game server the player plays on: jp (default), intl, usa or cn

versionstring

Game version whose new charts make the new 15 (b15): PRiSM PLUS. Default: the newest on the server.

suggestionsinteger

Most suggestions of scores to improve, 0 to 50. Default 10.

Tools (4)

calculate_best50

read-only

Argument	Type	Description
scores*	array	The scores of the player, up to 300; of a chart given twice the better one counts
server	string	Game server the player plays on: jp (default), intl, usa or cn
version	string	Game version whose new charts make the new 15 (b15): PRiSM PLUS. Default: the newest on the server.
suggestions	integer	Most suggestions of scores to improve, 0 to 50. Default 10.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "scores"
  ],
  "properties": {
    "scores": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "song",
          "achievement"
        ],
        "properties": {
          "song": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Sheet ID (dsht_…), or song ID or name with type and difficulty"
          },
          "type": {
            "enum": [
              "dx",
              "std",
              "utage",
              "utage2p"
            ],
            "type": "string",
            "description": "dx or std"
          },
          "combo": {
            "enum": [
              "fc",
              "fcp",
              "ap",
              "app"
            ],
            "type": "string",
            "description": "Combo lamp: fc, fcp (FC+), ap or app (AP+). AP and AP+ add 1 to the rating."
          },
          "difficulty": {
            "type": "string",
            "maxLength": 40,
            "description": "basic, advanced, expert, master or remaster"
          },
          "achievement": {
            "type": "integer",
            "maximum": 1010000,
            "minimum": 0,
            "description": "Achievement in 1/10000 of a percent, an integer: 100.7543% is 1007543, 99.5% is 995000"
          }
        }
      },
      "maxItems": 300,
      "minItems": 1,
      "description": "The scores of the player, up to 300; of a chart given twice the better one counts"
    },
    "server": {
      "type": "string",
      "maxLength": 20,
      "description": "Game server the player plays on: jp (default), intl, usa or cn"
    },
    "version": {
      "type": "string",
      "maxLength": 40,
      "description": "Game version whose new charts make the new 15 (b15): PRiSM PLUS. Default: the newest on the server."
    },
    "suggestions": {
      "type": "integer",
      "maximum": 50,
      "minimum": 0,
      "description": "Most suggestions of scores to improve, 0 to 50. Default 10."
    }
  }
}

calculate_rating

The rating a maimai DX chart gives for an achievement, the achievement a rating needs, and the rating of each rank (S to SSS+). Give a chart (looked up with its current internal level) or an internal level. Achievements are integers in 1/10000 of a percent: 100.7543% is 1007543.

read-only

Argument	Type	Description
song	string	The chart: a sheet ID (dsht_…), or a song ID or name with type and difficulty. Or give internal_level.
type	string	Type of the chart of song: dx or std
combo	string	Combo lamp: fc, fcp (FC+), ap or app (AP+). AP and AP+ add 1 to the rating.
server	string	Game server (jp, intl, usa, cn), whose internal level is used where it differs. Default jp.
difficulty	string	Difficulty of the chart of song: basic … remaster
achievement	integer	Achievement in 1/10000 of a percent, an integer: 100.7543% is 1007543, 99.5% is 995000
target_rating	integer	A rating of the chart to reach: the lowest achievement that gives it
internal_level	number

get_sheet

Details of a maimai DX song and its charts (譜面): level, internal level (譜面定数) now and in past versions, note counts, note designer, release date, servers and community tags. Filter by type, difficulty and server.

read-only

Argument	Type	Description
lang	string	Language of the tag names: en (default), ja, zh-Hans or zh-Hant. Use the language of the user.
song*	string	Song ID (dsng_…) or sheet ID (dsht_…) from search_songs. A title or alias that only one song has works too.
type	string	Only the charts of this type: dx, std, utage or utage2p
server	string	Game server: jp, intl, usa or cn. Only the charts on that server, with its own level where it differs. Omitted: every chart, with the servers of each.
difficulty	string	Only the charts of this difficulty: basic, advanced, expert, master or remaster (MAS, Re:MAS work)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "song"
  ],
  "properties": {
    "lang": {
      "enum": [
        "en",
        "ja",
        "zh-Hans",
        "zh-Hant"
      ],
      "type": "string",
      "description": "Language of the tag names: en (default), ja, zh-Hans or zh-Hant. Use the language of the user."
    },
    "song": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Song ID (dsng_…) or sheet ID (dsht_…) from search_songs. A title or alias that only one song has works too."
    },
    "type": {
      "enum": [
        "dx",
        "std",
        "utage",
        "utage2p"
      ],
      "type": "string",
      "description": "Only the charts of this type: dx, std, utage or utage2p"
    },
    "server": {
      "type": "string",
      "maxLength": 20,
      "description": "Game server: jp, intl, usa or cn. Only the charts on that server, with its own level where it differs. Omitted: every chart, with the servers of each."
    },
    "difficulty": {
      "type": "string",
      "maxLength": 40,
      "description": "Only the charts of this difficulty: basic, advanced, expert, master or remaster (MAS, Re:MAS work)"
    }
  }
}

search_songs

Finds maimai DX songs by title, alias, nickname, romanization or artist, best match first, with the level and internal level (譜面定数) of each chart. Use it to get the song ID of a song the user names.

read-only

Argument	Type	Description
type	string	Only the songs that have a chart of this type, and only those charts: dx, std, utage or utage2p
limit	integer	Most songs to return, 1 to 50. Default 10.
query*	string	Title, alias, nickname, romanization or artist, in any language: ウミユリ海底譚, umiyuri, 海底谭, n-buna. Width, case, kana and punctuation are ignored.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "type": {
      "enum": [
        "dx",
        "std",
        "utage",
        "utage2p"
      ],
      "type": "string",
      "description": "Only the songs that have a chart of this type, and only those charts: dx, std, utage or utage2p"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Most songs to return, 1 to 50. Default 10."
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Title, alias, nickname, romanization or artist, in any language: ウミユリ海底譚, umiyuri, 海底谭, n-buna. Width, case, kana and punctuation are ignored."
    }
  }
}