# Merchgraph

> Merchgraph is a free MCP server for e-commerce. Identify anime and game merch, see release prices and learn how to buy it. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://merchgraph.app
- **Repository:** https://github.com/marleyhereicome-cpu/kh-merch-graph
- **MCP Registry name:** io.github.marleyhereicome-cpu/merchgraph
- **Categories:** e-commerce, games and play
- **Listing updated:** 2026-11-14

## About

Merchgraph is a guide to merchandise, not a shop. Each item has a page showing what it is, its maker, release date and the price at release, which for lottery prizes means the price of one draw. It also explains how fans outside Japan get the item and whether a proxy service is needed.

Official items and fan-made brands are labelled separately so they are never confused. Prices are the maker's price at release, not resale value, and every fact links to a source such as the maker's page, an official shop or reliable press.

The MCP server lets an assistant identify an item from a listing title, check its release price and ask about proxy needs. It needs no API key or sign-up, and an `/llms.txt` file and OpenAPI reference help agents that discover servers by URL. A `report_correction` tool lets users flag errors.

## Features

- **Item identification:** Match a listing title to a specific item.
- **Release prices:** Maker's price at release, with source.
- **Buying guidance:** Whether a proxy service is needed from Japan.
- **Official vs fan-made:** Clearly labelled categories.
- **Correction reports:** Flag wrong facts.

## Good for

- Check if a marketplace listing is official merch
- Find the original price of a lottery prize
- Decide if a proxy service is needed
- Discover overseas exclusives for a series

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http merchgraph https://mcp.merchgraph.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.merchgraph.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "merchgraph": {
      "url": "https://mcp.merchgraph.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "merchgraph": {
      "type": "http",
      "url": "https://mcp.merchgraph.app/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "merchgraph": {
      "serverUrl": "https://mcp.merchgraph.app/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "merchgraph": {
      "type": "http",
      "url": "https://mcp.merchgraph.app/mcp"
    }
  }
}
```

## Tools

- `resolve_listing`: Identify a Kingdom Hearts, Demon Slayer and One Piece item from a marketplace listing (Mercari, Yahoo! Auctions, Suruga-ya, Mandarake, eBay…). Paste the listing title as-is (Japanese or English), e.g. {title: "一番くじ キングダムハーツ A賞 ソラ フィギュア 箱なし", price_jpy: 4500}. Returns candidates[] (sku_id, name_en, confidence 0-1, why, source_url, page_url = the item's page on merchgraph.app; several when the title
- `resolve_listings_batch`: Run resolve_listing on up to 5 listings in one call, e.g. when comparing search results from a marketplace. Example: {listings: [{title: "…", price_jpy: 3000}, {title: "…"}]}. Returns an array in the same order; each element has the same shape as a resolve_listing result (or {error} for that one listing only). For more than 5, split into several calls. For a single listing use resolve_listing.
- `explain_product`: Get the full record for one catalog item (Kingdom Hearts, Demon Slayer and One Piece). Pass a sku_id from discover/resolve_listing (e.g. {sku_id: "ichiban-kuji-kh-2018-a"}), or a free-text query such as {query: "Sora Bring Arts Halloween Town"} to get the best match. Returns names (en/ja), product line (maker, line type, release date), characters, original price (msrp_jpy, price_local, currency, p
- `discover`: Browse the merchandise catalog (Kingdom Hearts, Demon Slayer and One Piece) by series, character, budget and purpose. Use it to answer "what merch exists for X?" or "gift ideas under ¥5,000". Example: {ip: "kingdom-hearts", character: "Sora", budget_jpy: 5000, purpose: "display"}. Omit ip to search every series. Returns items[] (sku_id, name_en/name_ja, official, original price msrp_jpy plus price
- `estimate_landed_cost`: Estimate the total cost of buying an item in Japan and having it forwarded abroad. Example: {price_jpy: 4500, sku_id: "ichiban-kuji-kh-2018-a", dest_country: "US"}. Returns routes[] (forwarding service × shipping method, with fees and total_jpy, cheapest first) and cheapest. Rough figures only: fee and shipping tables currently cover US, GB, DE and FR (other countries return no routes), come from 
- `report_correction`: Report a mistake or missing item in the catalog (reviewed by hand before anything changes). Example: {sku_id: "ichiban-kuji-kh-2018-a", field: "msrp_jpy", proposed_value: "750", source_url: "https://…"}. Please include a primary source (maker, official shop or reliable press) when you can. Returns {accepted, correction_id}.

## FAQ

### Does it sell anything?

No. The site says Merchgraph is a guide, not a store.

### Is a key needed?

No. The server is free with no sign-up or API key.

### Are prices current?

They are prices at release, not today's resale prices.

### How do I report a mistake?

Use the report_correction tool.

### Is Merchgraph free?

Yes. Merchgraph is free to use.

### How do I add Merchgraph to Claude Code?

Run this command in your terminal: claude mcp add --transport http merchgraph https://mcp.merchgraph.app/mcp

### What are the best alternatives to Merchgraph?

The closest alternatives to Merchgraph are O'So MCP Server for PrestaShop, SecureCloud, AvatarSay — Fictional Character & Talking Video MCP, MadMax Trade Supply parts and VfxSmith.

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/merchgraph
