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 · SCANNED SEP 20

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

0 this week 79 Trust /100
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 native-build step with no shell scripting around it. View diagnostics → Pass
  • 1 of 23 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency32
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 Management87
  • Stability observed for 26 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
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
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
// .cursor/mcp.json
{
  "mcpServers": {
    "kcw2034-maplestory-mcp-server": {
      "command": "uvx",
      "args": [
        "maplestory-mcp-server"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "kcw2034-maplestory-mcp-server": {
      "command": "uvx",
      "args": [
        "maplestory-mcp-server"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add kcw2034-maplestory-mcp-server -- uvx maplestory-mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kcw2034-maplestory-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "maplestory-mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add kcw2034-maplestory-mcp-server --command uvx --arg maplestory-mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  kcw2034-maplestory-mcp-server:
    command: "uvx"
    args: ["maplestory-mcp-server"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "kcw2034-maplestory-mcp-server": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "maplestory-mcp-server"
      ]
    }
  }
}
# add to Vellum
assistant mcp add kcw2034-maplestory-mcp-server -t stdio -c uvx -a maplestory-mcp-server
// mcp.json
{
  "mcpServers": {
    "kcw2034-maplestory-mcp-server": {
      "command": "uvx",
      "args": [
        "maplestory-mcp-server"
      ]
    }
  }
}
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.

  • 20 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.

  • 18 Sept 26 −3
    • Stability: pass → 0.80 functional
  • 17 Sept 26 +1
    • Stability: 0.97 → pass security
  • 15 Sept 26 +16
    • Malware scan: unverified → pass security
  • 14 Sept 26 −15
    • Malware scan: pass → unverified security
  • 13 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.

  • 11 Sept 26 −3
    • Stability: pass → 0.80 functional
  • 10 Sept 26 +1
    • Stability: 0.97 → pass security
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 20 Sept 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

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 23 packages
Packages resolved 23
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.

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 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 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 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.