Skip to content

MCP server

Mercari Japan MCP Server

Local MCP server that searches Mercari Japan listings and returns product and price data to MCP clients like Claude Desktop.

  • Community
  • Runs locally
  • No credentials

Repository and documentation last checked Built from public product pages and documentation. SourcesClaim this listing

ecommerceguide summary

Mercari Japan MCP Server searches jp.mercari.com listings and returns product and price data to an MCP client. Search calls take a query, excluded keywords and minimum and maximum prices, and access is read-only. It is a Python FastMCP server run locally from a cloned repository with uv, over stdio, with no credentials to configure. The README covers Claude Desktop setup and MCP Inspector testing. Maintained by msr2903 under the MIT licence.

Why it stands out

Community Python FastMCP server built on the open mercari library, run from source with uv and no credentials.

What Mercari Japan MCP Server does

ecommerceguide editorial
  • Searches Mercari Japan listings and returns product and price data
  • Query parameters cover keywords, excluded keywords, minimum and maximum price
  • Read-only: no listing, buying or account write actions
  • Runs locally over stdio via uv, no authentication required
  • Claude Desktop config example and MCP Inspector testing in the README
  • Python FastMCP project, MIT licence, maintained by msr2903

How ecommerce teams could use it

ecommerceguide editorial

Illustrative scenarios written by ecommerceguide from the product's documented capabilities. They are not customer case studies.

  1. Reseller sourcing Japanese secondhand stock who works in Claude Desktop

    Checking what comparable items are currently listed for on Mercari Japan before buying

    Intended outcomeThe server runs the search with price bounds and excluded keywords and returns current listing and price data in the chat.

  2. Developer building an agent that reads marketplace listings

    Adding a Mercari Japan lookup to a local MCP client without writing a scraper

    Intended outcomeThe repo is cloned, installed with uv and registered as a stdio server, exposing search over Mercari listings.

Who it suits

ecommerceguide editorial

Best for

You want read-only Mercari Japan listing and price lookups inside Claude Desktop or another MCP client and can run a local Python server.

Probably not for

You need a hosted endpoint, marketplaces other than Mercari Japan, or write actions such as listing and purchasing, since this is local and read-only.

Business size
Any stageFree community repository under the MIT licence with no stated audience or usage bounds.
Verticals
Marketplaces

Technical details

From the vendor's own pages

From the server's repository, documentation and MCP directory listings.

What an agent can do
Manage products
Transport
stdio (local)
Authentication
No credentialsSetup only requires cloning the repo and installing dependencies; no credentials mentioned.
Package
mercari-mcp
Language
Python
Licence
MIT
Repository last updated
17 Aug 2026

Connect Mercari Japan MCP Server

Third-party data

Setup documented for

Install command
git clone https://github.com/msr2903/mercari-jp-mcp.git && cd mercari-jp-mcp && uv venv && uv pip install -e .

Command as listed on the repository README, not tested by ecommerceguide. Check the repository README (opens in a new tab) for configuration and credentials before running it.

Categories and use cases