io.github.kcw2034/maplestory-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MAPLESTORY_API_KEY | Yes | Your MapleStory API key from Nexon OpenAPI |
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 | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_character_ocidA | 캐릭터 이름으로 OCID(캐릭터 식별자)를 조회합니다. 다른 캐릭터 정보 조회에 필요한 값입니다. |
| get_character_basicB | 캐릭터 기본 정보(레벨, 직업, 월드, 길드, 캐릭터 이미지 등)를 조회합니다. |
| get_character_statA | 캐릭터 종합 스탯(STR, DEX, 전투력 등)을 조회합니다. |
| get_character_popularityB | 캐릭터 인기도를 조회합니다. |
| get_character_hyper_statA | 캐릭터 하이퍼스탯 정보를 조회합니다. |
| get_character_propensityC | 캐릭터 성향 정보(카리스마, 매력 등)를 조회합니다. |
| get_character_abilityB | 캐릭터 어빌리티(내부 능력) 정보를 조회합니다. |
| get_character_item_equipmentB | 캐릭터 장착 장비 정보를 조회합니다. |
| get_character_cashitem_equipmentB | 캐릭터 캐시 장비 정보를 조회합니다. |
| get_character_symbol_equipmentB | 캐릭터 심볼(아케인/어센틱) 장비 정보를 조회합니다. |
| get_character_set_effectA | 캐릭터 적용 세트 효과 정보를 조회합니다. |
| get_character_beauty_equipmentA | 캐릭터 헤어/성형/피부 정보를 조회합니다. |
| get_character_android_equipmentA | 캐릭터 안드로이드 장비 정보를 조회합니다. |
| get_character_pet_equipmentB | 캐릭터 펫 장비 정보를 조회합니다. |
| get_character_skillB | 캐릭터 스킬 정보를 조회합니다. character_skill_grade: 0=1차, 1=2차, ..., 5=5차, 6=6차, hyperpassive, hyperactive |
| get_character_link_skillC | 캐릭터 링크 스킬 정보를 조회합니다. |
| get_character_vmatrixA | 캐릭터 V매트릭스(5차 스킬 코어) 정보를 조회합니다. |
| get_character_hexamatrixC | 캐릭터 HEXA매트릭스(6차 스킬) 정보를 조회합니다. |
| get_character_hexamatrix_statB | 캐릭터 HEXA 스탯 정보를 조회합니다. |
| get_character_dojangB | 캐릭터 무릉도장 최고 기록을 조회합니다. |
| get_unionA | 유니온 레벨 및 등급 정보를 조회합니다. |
| get_union_raiderB | 유니온 공격대 배치 및 효과 정보를 조회합니다. |
| get_union_artifactC | 유니온 아티팩트 정보를 조회합니다. |
| get_guild_idA | 길드 이름과 월드명으로 길드 식별자(oguild_id)를 조회합니다. |
| get_guild_basicB | 길드 기본 정보(멤버, 스킬 등)를 조회합니다. |
| get_ranking_overallC | 종합 랭킹을 조회합니다. |
| get_ranking_unionC | 유니온 랭킹을 조회합니다. |
| get_ranking_guildB | 길드 랭킹을 조회합니다. |
| get_ranking_dojangC | 무릉도장 랭킹을 조회합니다. |
| get_ranking_theseedC | 더 시드 랭킹을 조회합니다. |
| get_ranking_achievementC | 업적 랭킹을 조회합니다. |
| get_history_starforceB | 스타포스 강화 이력을 조회합니다. |
| get_history_cubeB | 큐브 사용 이력을 조회합니다. |
| get_history_potentialC | 잠재능력 재설정 이력을 조회합니다. |
| get_noticesB | 메이플스토리 공지사항 목록을 조회합니다. |
| get_notice_detailB | 특정 공지사항 상세 내용을 조회합니다. |
| get_update_noticesA | 업데이트 공지 목록을 조회합니다. |
| get_event_noticesB | 이벤트 공지 목록을 조회합니다. |
| get_cashshop_noticesA | 캐시샵 공지 목록을 조회합니다. |
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 39 tools
Every tool follows a clear get_<category>_<subcategory> pattern and maps to a distinct API resource: character stats, equipment categories, skills, union/guild, rankings, histories, and notices are all unambiguous. Even near-neighbor tools like get_character_vmatrix vs get_character_hexamatrix are separated by explicit grade/domain.
All 39 tools use the same verb prefix (`get_`) and snake_case noun hierarchy, making the namespace highly predictable. Minor structural differences (e.g., `get_union` vs `get_guild_basic`) reflect actual resource groupings rather than inconsistent style.
At 39 tools, the set is well beyond the 25+ threshold and will be heavy for agents to navigate, even though each endpoint is distinct. The server could be reduced by grouping related lookups (e.g., one notices tool with category filters or one equipment tool with a type parameter).
The set covers the full MapleStory read-only domain: character basics/equipment/skills/progress, union, guild, all ranking categories, enhancement histories, and notice retrieval with detail lookup. There are no obvious dead ends; prerequisite lookup tools (OCID, guild ID) are included.