Labsco
MCP SERVER

MapleStory MCP Server

by ljy9303

Look up MapleStory characters, unions, guilds and rankings through NEXON's open API, and read the cube and starforce probability tables before spending anything.

Games, Entertainment & FandomVerified
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