Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.kcw2034/maplestory-mcp-server

PYPI · MAPLESTORY-MCP-SERVER

MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices

0 this week 83 Trust /100

Last scanned (17 hours ago)

Scores higher than 86% of PyPI servers

Category Entertainment and Games

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
  • 1 of 22 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability69
  • AI-judged instruction clarity (good).Pass
  • Tool/resource definitions use about 2052 tokens (~52/item across 39 items; 39 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • We read all 39 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
  • An AI judge read all 39 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 4 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 3 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 1 Nov 26 0
    • Security disclosure: unverified → fail ▼ functional
  • 31 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
    • Security disclosure: fail → unverified ▼ functional
  • 30 Oct 26 −15
    • Malware scan: pass → unverified ▼ security
    • Stability: 0.97 → pass security
  • 29 Oct 26 0
    • Stability: pass → 0.97 functional
  • 28 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
  • 27 Oct 26 −15
    • Malware scan: pass → unverified ▼ security
    • Security disclosure: unverified → fail ▼ functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Nov 2026 · Analysed pypi/maplestory-mcp-server@1.0.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem pypi
Reason No attestation published

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend allowlisted hatchling.build

Background: Why install scripts are a supply-chain risk →

Dependencies 22 packages
Packages resolved 22
Stale 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 39 exposed · ~2,052 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
get_cashshop_notices ~21

캐시샵 공지 목록을 조회합니다.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

get_character_ability ~52

캐릭터 어빌리티(내부 능력) 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_android_equipment ~49

캐릭터 안드로이드 장비 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_basic ~69

캐릭터 기본 정보(레벨, 직업, 월드, 길드, 캐릭터 이미지 등)를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD). 미입력 시 최근 데이터 조회
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_beauty_equipment ~53

캐릭터 헤어/성형/피부 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_cashitem_equipment ~48

캐릭터 캐시 장비 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_dojang ~50

캐릭터 무릉도장 최고 기록을 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_hexamatrix ~55

캐릭터 HEXA매트릭스(6차 스킬) 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_hexamatrix_stat ~49

캐릭터 HEXA 스탯 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_hyper_stat ~49

캐릭터 하이퍼스탯 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_item_equipment ~47

캐릭터 장착 장비 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_link_skill ~45

캐릭터 링크 스킬 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_ocid ~51

캐릭터 이름으로 OCID(캐릭터 식별자)를 조회합니다. 다른 캐릭터 정보 조회에 필요한 값입니다.

NameTypeReqDescription
character_namestringyes캐릭터 이름

Structured output declared, but exposes no named fields.

No examples provided.

get_character_pet_equipment ~47

캐릭터 펫 장비 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_popularity ~44

캐릭터 인기도를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_propensity ~53

캐릭터 성향 정보(카리스마, 매력 등)를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_set_effect ~46

캐릭터 적용 세트 효과 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_skill ~103

캐릭터 스킬 정보를 조회합니다. character_skill_grade: 0=1차, 1=2차, ..., 5=5차, 6=6차, hyperpassive, hyperactive

NameTypeReqDescription
character_skill_gradestringyes스킬 차수 (0~6, hyperpassive, hyperactive)
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_stat ~56

캐릭터 종합 스탯(STR, DEX, 전투력 등)을 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_symbol_equipment ~56

캐릭터 심볼(아케인/어센틱) 장비 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_character_vmatrix ~55

캐릭터 V매트릭스(5차 스킬 코어) 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_event_notices ~18

이벤트 공지 목록을 조회합니다.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

get_guild_basic ~56

길드 기본 정보(멤버, 스킬 등)를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
oguild_idstringyes길드 식별자 (oguild_id)

Structured output declared, but exposes no named fields.

No examples provided.

get_guild_id ~69

길드 이름과 월드명으로 길드 식별자(oguild_id)를 조회합니다.

NameTypeReqDescription
guild_namestringyes길드 이름
world_namestringyes월드 이름 (스카니아, 베라, 루나, 리부트 등)

Structured output declared, but exposes no named fields.

No examples provided.

get_history_cube ~56

큐브 사용 이력을 조회합니다.

NameTypeReqDescription
countintegeryes한 번에 조회할 건수
cursor––이전 응답의 next_cursor 값
date––조회 기준일 (YYYY-MM-DD)

Structured output declared, but exposes no named fields.

No examples provided.

get_history_potential ~60

잠재능력 재설정 이력을 조회합니다.

NameTypeReqDescription
countintegeryes한 번에 조회할 건수
cursor––이전 응답의 next_cursor 값
date––조회 기준일 (YYYY-MM-DD)

Structured output declared, but exposes no named fields.

No examples provided.

get_history_starforce ~57

스타포스 강화 이력을 조회합니다.

NameTypeReqDescription
countintegeryes한 번에 조회할 건수
cursor––이전 응답의 next_cursor 값
date––조회 기준일 (YYYY-MM-DD)

Structured output declared, but exposes no named fields.

No examples provided.

get_notice_detail ~30

특정 공지사항 상세 내용을 조회합니다.

NameTypeReqDescription
notice_idintegeryes공지사항 ID

Structured output declared, but exposes no named fields.

No examples provided.

get_notices ~22

메이플스토리 공지사항 목록을 조회합니다.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

get_ranking_achievement ~51

업적 랭킹을 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocid––특정 캐릭터 OCID
page––페이지 번호

Structured output declared, but exposes no named fields.

No examples provided.

get_ranking_dojang ~71

무릉도장 랭킹을 조회합니다.

NameTypeReqDescription
class_––직업
date––조회 기준일 (YYYY-MM-DD)
ocid––특정 캐릭터 OCID
page––페이지 번호
world_name––월드 이름

Structured output declared, but exposes no named fields.

No examples provided.

get_ranking_guild ~87

길드 랭킹을 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
guild_name––길드 이름
page––페이지 번호
ranking_type––랭킹 타입 (0: 주간, 1: 플래그, 2: 지하수로)
world_name––월드 이름

Structured output declared, but exposes no named fields.

No examples provided.

get_ranking_overall ~98

종합 랭킹을 조회합니다.

NameTypeReqDescription
class_––직업 (전사, 마법사, 궁수 등)
date––조회 기준일 (YYYY-MM-DD)
ocid––특정 캐릭터 OCID
page––페이지 번호
world_name––월드 이름
world_type––월드 타입 (0: 일반, 1: 리부트)

Structured output declared, but exposes no named fields.

No examples provided.

get_ranking_theseed ~62

더 시드 랭킹을 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocid––특정 캐릭터 OCID
page––페이지 번호
world_name––월드 이름

Structured output declared, but exposes no named fields.

No examples provided.

get_ranking_union ~60

유니온 랭킹을 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocid––특정 캐릭터 OCID
page––페이지 번호
world_name––월드 이름

Structured output declared, but exposes no named fields.

No examples provided.

get_union ~45

유니온 레벨 및 등급 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_union_artifact ~46

유니온 아티팩트 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_union_raider ~48

유니온 공격대 배치 및 효과 정보를 조회합니다.

NameTypeReqDescription
date––조회 기준일 (YYYY-MM-DD)
ocidstringyes캐릭터 OCID

Structured output declared, but exposes no named fields.

No examples provided.

get_update_notices ~18

업데이트 공지 목록을 조회합니다.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

Install

How do I install the io.github.kcw2034/maplestory-mcp-server server?

io.github.kcw2034/maplestory-mcp-server runs locally as a PyPI package, launched with uvx maplestory-mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · maplestory-mcp-server

# add to Claude Code
claude mcp add kcw2034-maplestory-mcp-server -- uvx maplestory-mcp-server
Common questions

What is the io.github.kcw2034/maplestory-mcp-server server?

io.github.kcw2034/maplestory-mcp-server is listed in the public MCP registry as io.github.kcw2034/maplestory-mcp-server. MCP server for Nexon MapleStory OpenAPI - character, rankings, union, guild, and notices. This page covers its PyPI package (maplestory-mcp-server).

Is the io.github.kcw2034/maplestory-mcp-server server safe to use?

io.github.kcw2034/maplestory-mcp-server scores 83 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 November 2026. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.kcw2034/maplestory-mcp-server server expose?

io.github.kcw2034/maplestory-mcp-server exposes 39 tools: get_character_ocid, get_character_basic, get_character_stat, get_character_popularity, get_character_hyper_stat, and 34 more. Their descriptions and schemas cost roughly 2,052 tokens of context every time the server is loaded.

Is the io.github.kcw2034/maplestory-mcp-server server still maintained?

io.github.kcw2034/maplestory-mcp-server is still listed as active in the MCP registry. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the io.github.kcw2034/maplestory-mcp-server server under?

io.github.kcw2034/maplestory-mcp-server declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.