MCP server · owned by msu

maple-lookup

MapleStory Universe resource tools. One server, owned by one plugin — downstream plugins consume it through a dependency, never by redefining it.

2 tools2 skills call itkey required

Connection

What the plugin declares

Every value here is read from the plugin’s own .mcp.json, so this page cannot describe the server differently from the file that defines it.

transport: HTTP / streamable HTTP
url: https://openapi.msu.io/v1rc1/resource/mcp
header: x-nxopen-api-key
credential: MSU Builder OpenAPI Key

OpenAPI key issued from the MSU Builder Center; sent as the x-nxopen-api-key header to the maple-lookup MCP server

Never commit it — pass it through the environment.

Tools

What the server answers

maple-lookup_search

Fuzzy search by name (Korean/English)

maple-lookup_get_sprite_data

Fetch sprite/skill data from CDN

Setup by hand

Every channel but Claude Code

Codex CLI

Add to ~/.codex/config.toml. The key is read from the environment at runtime.

[mcp_servers.maple-lookup]
url = "https://openapi.msu.io/v1rc1/resource/mcp"
env_http_headers = { "x-nxopen-api-key" = "MSU_OPENAPI_KEY" }

Gemini CLI

One command. The key has to be exported when the server is registered.

gemini mcp add --transport http --header "x-nxopen-api-key: $MSU_OPENAPI_KEY" maple-lookup https://openapi.msu.io/v1rc1/resource/mcp

Kimi CLI

Same shape as Gemini.

kimi mcp add --transport http --header "x-nxopen-api-key: $MSU_OPENAPI_KEY" maple-lookup https://openapi.msu.io/v1rc1/resource/mcp

Callers

Skills that need this server

maple-make

msu:maple-makeneeds maple-lookup37 files

Use when working with MapleStory assets — how to look up, compose, and render characters, mobs, maps, skills, items, or sprites via maple-lookup MCP.

maple-preview

msu:maple-previewneeds maple-lookupone file

Use when a MapleStory asset request resolves to more than one plausible candidate: a look described by colour, style, or mood instead of an exact name or ID (a black cap, a white tee, a monster that suits this map), a maple-lookup search returning several close matches, or the user asking to preview, compare, or choose between assets before they are used.

Read the rest

Builds a local page the user picks from; when it was not invoked by name, it asks first.