get_character_basic_info
Retrieve basic information about a MapleStory character including level, job, world, and guild
LABSCO SUMMARY
The reads take a date as well as a name, which makes this a time series rather than a snapshot.
characterName plus date is the shape of the character, stats, equipment, union, guild and ranking tools alike, so "how did this change" is a loop over dates rather than a different endpoint. get_character_full_info exists to keep that loop cheap, folding basic info, stats and equipment into one request with includeEquipment as the switch. The probability tools sit outside that pattern: get_cube_probability and get_starforce_probability describe the game's odds, not a player, and answer the question before the meso is spent.
What it is
A NEXON open-API client for MapleStory with 15 tools covering character records, union and guild standing, world rankings, in-game notices and enhancement probability data.
What you get
- Character records by name and date: get_character_basic_info for level, job, world and guild, get_character_stats for damage, critical rate and combat stats, get_character_equipment for equipped items and their stats, and get_character_full_info to take all three in one request.
- Union standing: get_union_info for level, grade and artifact detail, get_union_raider for block placement on the raider board, and get_union_ranking by world or overall.
- Guild and ladder data: get_guild_info for level, members and skills, get_guild_ranking, and get_overall_ranking filtered by className, worldName and worldType.
- Enhancement probability tables: get_cube_probability by cubeType, itemLevel and potentialGrade, and get_starforce_probability by currentStars, targetStars, itemLevel and eventType.
- Game announcements through get_notice_list and get_notice_detail, and a health_check that reports on the NEXON API connection as well as the server.
Requirements
A NEXON open-API key, supplied as NEXON_API_KEY.
Setup effort
One command plus a key — npx maplestory-mcp-server --api-key <YOUR_NEXON_API_KEY>, then supply credentials
USE CASES
01
Taking a full picture of a character as it stood on a given day
Basic info, combat stats and equipment come back in one request when you want all three; the same call with a different date is how you compare two points in time.
02
Deciding whether a starforce or cube attempt is worth the meso
The odds are a lookup rather than a guess: both tables take the item level and the grade or star range you are actually attempting.
03
Tracking where a guild and its members sit on the ladder
Guild standing, union power and the overall level ladder are separate rankings, each filterable by world.
04
Reading the union board before rearranging it
Level, grade and artifact detail come from one tool and the block layout from another, so you can see the ceiling and the current placement side by side.
05
Catching up on what the game announced
The notice list is filterable by type and paged; the detail tool then pulls the body of one entry.
15 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_character_equipment
Retrieve equipment information for a MapleStory character including all equipped items and their stats
get_character_full_info
Retrieve comprehensive character information including basic info, stats, and equipment in a single request
get_character_stats
Retrieve detailed statistics for a MapleStory character including damage, critical rate, and all combat stats
get_cube_probability
Retrieve cube usage probability information and enhancement statistics
get_guild_info
Retrieve basic information about a MapleStory guild including level, members, and skills
get_guild_ranking
Retrieve guild rankings for a specific world or overall rankings
get_notice_detail
Retrieve detailed information for a specific MapleStory notice
get_notice_list
Retrieve list of MapleStory game notices and announcements
get_overall_ranking
Retrieve overall level rankings for MapleStory characters with filtering options
get_starforce_probability
Retrieve starforce enhancement probability information and success rates
get_union_info
Retrieve union information for a MapleStory character including level, grade, and artifact details
get_union_raider
Retrieve union raider board information including block placement and stats
get_union_ranking
Retrieve union power rankings for a specific world or overall rankings
health_check
Check the health status of the MCP server and NEXON API connection
BEFORE YOU INSTALL
What to know first
Tools you get
15 tools when we connected. All tools read. The NEXON key allows 500 calls a day, one per second, and get_character_full_info uses several calls per invocation. The documentation is in Korean.
Requires
- npx on PATH
- Node.js 18+
- NEXON_API_KEY in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 15 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
Any MCP client — npx
Get an API key from the NEXON Open API portal (https://openapi.nexon.com/), signing in with your NEXON account; it goes in NEXON_API_KEY, or in --api-key on the command line
TERMINAL
npx maplestory-mcp-server --api-key <YOUR_NEXON_API_KEY>MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"maplestory-mcp-server": {
"command": "npx",
"args": [
"-y",
"maplestory-mcp-server"
],
"env": {
"NEXON_API_KEY": "<YOUR_NEXON_API_KEY>"
}
}
}
}Global npm install
GLOBAL NPM INSTALL · TERMINAL
npm install -g maplestory-mcp-server
