# Japan → Korea Bridge

> Japan → Korea Bridge is an open-source MCP server for e-commerce. Searches Rakuten and Yahoo Japan, then prices Japan-to-Korea buying-agent orders. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://appmonster.co.kr
- **Repository:** https://github.com/groove79/kmcp/tree/HEAD/packages/japan-bridge
- **MCP Registry name:** io.github.groove79/mcp-japan-bridge
- **Categories:** e-commerce
- **Listing updated:** 2026-11-15

## About

This server is built for people who run a Japan buying-agent store for Korean shoppers (일본구매대행). An agent can search two Japanese marketplaces, work out what an item really costs once it lands in Korea, and prepare a Naver Smart Store product draft.

The landed-cost tool chains the exchange rate, your forwarder's shipping tariff, Korean customs rules, the marketplace fee and a target margin, and explains each step. It encodes the USD 150 duty-free threshold and the simple or general duty modes, and warns about combined taxation when quantities are split. The README says results are estimates for pricing decisions, since customs uses its own weekly rate.

The draft tool fills origin Japan, lead time and the notices Korean consumer law expects for overseas buying-agent sales, plus a pre-publish checklist. All tools are read-only and nothing is posted; the author pairs it with the separate Naver Commerce server to publish.

## Features

- **Rakuten search:** Keyword search returning price, shop, image, reviews, stock and a shipping flag.
- **Yahoo Japan search:** The same result shape from Yahoo! JAPAN Shopping, at one request per second.
- **Exchange rates:** Mid-market JPY to KRW and USD to KRW rates with no key.
- **Landed cost and price:** Computes shipping, customs, marketplace fee and a suggested selling price with each step explained.
- **Smart Store draft:** Creates a Naver product draft with origin, lead time, required notices and a checklist.
- **Configurable fees:** Forwarder base fee, per-kg rate and platform fee rate are set through environment variables.

## Good for

- Compare Japanese listings for an item before sourcing it
- Price an order with duty and VAT included
- Set a selling price from a target margin
- Draft a Smart Store listing with the required disclosures
- Check whether a parcel falls under the duty-free threshold

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-japan-bridge --env RAKUTEN_ACCESS_KEY='<RAKUTEN_ACCESS_KEY>' -- npx -y @appmonster/mcp-japan-bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-japan-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-japan-bridge"
      ],
      "env": {
        "RAKUTEN_ACCESS_KEY": "<RAKUTEN_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-japan-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-japan-bridge"
      ],
      "env": {
        "RAKUTEN_ACCESS_KEY": "<RAKUTEN_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-japan-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-japan-bridge"
      ],
      "env": {
        "RAKUTEN_ACCESS_KEY": "<RAKUTEN_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-japan-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-japan-bridge"
      ],
      "env": {
        "RAKUTEN_ACCESS_KEY": "<RAKUTEN_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-japan-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@appmonster/mcp-japan-bridge"
      ],
      "env": {
        "RAKUTEN_ACCESS_KEY": "<RAKUTEN_ACCESS_KEY>"
      }
    }
  }
}
```

## Tools

- `jp_search_rakuten`: Rakuten Ichiba keyword search with price, shop, image, reviews, stock and shipping flag.
- `jp_search_yahoo`: Yahoo! JAPAN Shopping search in the same shape.
- `jp_fx_rate`: JPY to KRW and USD to KRW mid-market rates.
- `jp_landed_cost`: Full landed cost and suggested price across exchange, shipping, customs, fee and margin.
- `jp_listing_draft`: Naver originProduct draft with origin, lead time, notices and a pre-publish checklist.

## FAQ

### What credentials are needed?

A free Rakuten Web Service app id and access key and a free Yahoo! JAPAN Client ID. The exchange-rate tool needs no key.

### Are the shipping defaults accurate?

No. The README calls the defaults rough placeholders and tells you to set your forwarder's own tariff.

### Does it publish products?

No. All tools are read-only. The author suggests the separate Naver Commerce server for posting.

### How are customs rules handled?

Goods up to USD 150 per shipment are treated as duty-free; above that it applies a simple 20% rate or an HS-code rate plus VAT. Both are adjustable inputs.

### Is Japan → Korea Bridge free?

Yes. Japan → Korea Bridge is open source, so you can use and self-host it for free.

### How do I add Japan → Korea Bridge to Claude Code?

Run this command in your terminal: claude mcp add mcp-japan-bridge --env RAKUTEN_ACCESS_KEY='<RAKUTEN_ACCESS_KEY>' -- npx -y @appmonster/mcp-japan-bridge

### What are the best alternatives to Japan → Korea Bridge?

The closest alternatives to Japan → Korea Bridge are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## 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.
- [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.
- [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.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/japan-korea-bridge
