Content
# Maple Auction MCP
A MCP server for searching MapleStory auction house.
## Installation
First, install the [Chrome extension](https://chromewebstore.google.com) and log in to [MapleStory Auction House](https://auction.maplestory.nexon.com) on Chrome.
### Claude Code
```bash
claude mcp add --scope user maple-auction -- npx -y maple-auction-mcp
```
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"maple-auction": {
"command": "npx",
"args": ["-y", "maple-auction-mcp"]
}
}
}
```
### Codex
```bash
codex mcp add maple-auction -- npx -y maple-auction-mcp
```
### Antigravity CLI
Add to `~/.gemini/config/mcp_config.json` (create if not exists):
```json
{
"mcpServers": {
"maple-auction": {
"command": "npx",
"args": ["-y", "maple-auction-mcp"]
}
}
}
```
For Windows, use `"command": "cmd", "args": ["/c", "npx", "-y", "maple-auction-mcp"]`. Verify registration by typing `/mcp` in CLI. (For older CLI versions, use `~/.gemini/antigravity-cli/mcp_config.json`.)
> Gemini CLI support for personal accounts ended on 2026-06-18 and has been replaced by Antigravity CLI.
## Final Damage Increase Rate (Optional — NEXON Open API Key)
The `item_damage` tool calculates the **final damage increase rate (%)** when replacing an item with the current equipped gear — including main stats (% applied and not applied separately), attack power, boss damage, ignore defense rate (multiplicative), critical damage, final damage, and set effect changes. You can also query character equipped gear with `user_equip`.
Obtain an API key from [openapi.nexon.com](https://openapi.nexon.com) and append it to the execution arguments to enable:
```bash
claude mcp add --scope user maple-auction -- npx -y maple-auction-mcp --api-key YOUR_NEXON_API_KEY
```
## Usage Examples
> Search for 21% Arcane Chain
> Find Kadena weapons with high damage increase rate that I can equip
## Privacy Policy
The Chrome extension does not collect or transmit any data externally. Refer to the [Privacy Policy](docs/privacy-policy.md) for details.
## License
[MIT](LICENSE)
