Maplestory Mcp Server
Wraps the Nexon MapleStory OpenAPI so you can query game data directly from Claude. You get 30+ tools covering character stats and equipment, union raider layouts, guild lookups, rankings across multiple categories (overall, Dojang, The Seed), and enhancement history like starforce and cube rolls. Requires a free API key from Nexon's developer portal and Python 3.13 with uv. Reach for this when you're building MapleStory tools, analyzing player progression, tracking guild activity, or need to pull live game data without manual lookups. The character OCID lookup is your entry point for most operations since the API requires it to fetch player-specific data.
- tools
- 14
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 26, 2026
Tools
14 toolsPublic tool metadata for what this MCP can expose to an agent.
get_character_ocidLook up character OCID by name
Look up character OCID by name
No parameter schema in public metadata yet.
get_character_basicBasic info (level, class, world, guild)
Basic info (level, class, world, guild)
No parameter schema in public metadata yet.
get_character_statCombined stats (STR, DEX, combat power)
Combined stats (STR, DEX, combat power)
No parameter schema in public metadata yet.
get_character_item_equipmentEquipped items
Equipped items
No parameter schema in public metadata yet.
get_character_skillSkill info by grade
Skill info by grade
No parameter schema in public metadata yet.
get_character_hexamatrixHEXA matrix (6th job skills)
HEXA matrix (6th job skills)
No parameter schema in public metadata yet.
get_unionUnion level and grade
Union level and grade
No parameter schema in public metadata yet.
get_union_raiderUnion raider layout and effects
Union raider layout and effects
No parameter schema in public metadata yet.
get_guild_idLook up guild ID by name and world
Look up guild ID by name and world
No parameter schema in public metadata yet.
get_guild_basicGuild basic info
Guild basic info
No parameter schema in public metadata yet.
get_ranking_overallOverall ranking
Overall ranking
No parameter schema in public metadata yet.
get_ranking_dojangMu Lung Dojang ranking
Mu Lung Dojang ranking
No parameter schema in public metadata yet.
get_history_starforceStarforce enhancement history
Starforce enhancement history
No parameter schema in public metadata yet.
get_noticesOfficial notice list
Official notice list
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MAPLESTORY_API_KEY*secretAPI key from Nexon OpenAPI (https://open.api.nexon.com)
Readme
MapleStory MCP Server
An MCP (Model Context Protocol) server that wraps the Nexon MapleStory OpenAPI, allowing AI assistants to query MapleStory game data including character info, rankings, union, guild, and more.
Features
- Character - Basic info, stats, equipment, skills, V/HEXA matrix, Dojang records
- Union - Union level, raider layout, artifact info
- Guild - Guild search and basic info
- Ranking - Overall, union, guild, Dojang, The Seed, achievement rankings
- History - Starforce, cube, potential re-roll history
- Notice - Official notices, updates, events, cash shop notices
Prerequisites
- Python 3.13+
- uv package manager
- MapleStory API key from Nexon OpenAPI
Installation
# Clone the repository
git clone https://github.com/kcw2034/maplestory-mcp-server.git
cd maplestory-mcp-server
# Install dependencies
uv sync
Configuration
Create a .env file in the project root:
MAPLESTORY_API_KEY=your_api_key_here
You can get an API key by registering an app at Nexon OpenAPI.
Usage
Details
- Repository
- github.com/kcw2034/maplestory-mcp-server
- Package
maplestory-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active