MapleStory MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NODE_ENV | No | Environment mode (development/production) | |
| LOG_LEVEL | No | Logging level (default: "info") | info |
| NEXON_API_KEY | Yes | NEXON Open API Key (Required) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| health_checkB | Check the health status of the MCP server and NEXON API connection |
| get_character_basic_infoB | Retrieve basic information about a MapleStory character including level, job, world, and guild |
| get_character_statsC | Retrieve detailed statistics for a MapleStory character including damage, critical rate, and all combat stats |
| get_character_equipmentB | Retrieve equipment information for a MapleStory character including all equipped items and their stats |
| get_character_full_infoC | Retrieve comprehensive character information including basic info, stats, and equipment in a single request |
| get_union_infoC | Retrieve union information for a MapleStory character including level, grade, and artifact details |
| get_union_raiderC | Retrieve union raider board information including block placement and stats |
| get_union_rankingB | Retrieve union power rankings for a specific world or overall rankings |
| get_guild_infoB | Retrieve basic information about a MapleStory guild including level, members, and skills |
| get_guild_rankingB | Retrieve guild rankings for a specific world or overall rankings |
| get_overall_rankingC | Retrieve overall level rankings for MapleStory characters with filtering options |
| get_notice_listC | Retrieve list of MapleStory game notices and announcements |
| get_notice_detailC | Retrieve detailed information for a specific MapleStory notice |
| get_cube_probabilityC | Retrieve cube usage probability information and enhancement statistics |
| get_starforce_probabilityC | Retrieve starforce enhancement probability information and success rates |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
The tools have clear distinctions between character, guild, notice, union, and ranking categories, but there is notable overlap within character tools (get_character_basic_info, get_character_full_info, get_character_stats, get_character_equipment) where their purposes could be confused, especially since get_character_full_info appears to encompass the others. Descriptions help differentiate them, but an agent might struggle to choose the most efficient one.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., get_character_basic_info, get_guild_info, get_notice_list). The pattern is predictable and readable throughout the set, with no deviations in style or convention.
With 15 tools, the count is well-scoped for a MapleStory MCP server covering character, guild, notice, union, ranking, and server health aspects. Each tool earns its place by targeting specific resources or actions, and the number aligns with typical server scopes (3-15 tools).
The tool surface provides comprehensive coverage for retrieving information in the MapleStory domain, including character details, guild data, notices, union info, and rankings. Minor gaps exist, such as no tools for updating or creating data (e.g., modifying characters or guilds), but agents can work around this for read-only operations, and core workflows are well-covered.