Summary
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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
Running the server
uv run server.py
Claude Desktop configuration
Add this to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"maplestory": {
"command": "uv",
"args": ["run", "server.py"],
"cwd": "/path/to/maplestory-mcp-server",
"env": {
"MAPLESTORY_API_KEY": "your_api_key_here"
}
}
}
}
Available Tools
| Category | Tool | Description |
|---|---|---|
| Character | get_character_ocid | Look up character OCID by name |
| Character | get_character_basic | Basic info (level, class, world, guild) |
| Character | get_character_stat | Combined stats (STR, DEX, combat power) |
| Character | get_character_item_equipment | Equipped items |
| Character | get_character_skill | Skill info by grade |
| Character | get_character_hexamatrix | HEXA matrix (6th job skills) |
| Union | get_union | Union level and grade |
| Union | get_union_raider | Union raider layout and effects |
| Guild | get_guild_id | Look up guild ID by name and world |
| Guild | get_guild_basic | Guild basic info |
| Ranking | get_ranking_overall | Overall ranking |
| Ranking | get_ranking_dojang | Mu Lung Dojang ranking |
| History | get_history_starforce | Starforce enhancement history |
| Notice | get_notices | Official notice list |
See
server.pyfor the full list of 30+ tools.
License
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
MAPLESTORY_API_KEY*secretAPI key from Nexon OpenAPI (https://open.api.nexon.com)
Registryactive
Packagemaplestory-mcp-server
TransportSTDIO
AuthRequired
UpdatedMar 26, 2026