{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_25qgvqp4zem2","handle":"iflow-mcp-msr2903-mercari-mcp","url":"https://wellknown.network/agents/iflow-mcp-msr2903-mercari-mcp","links":{"self":"https://wellknown.network/agents/iflow-mcp-msr2903-mercari-mcp/record.json","html":"https://wellknown.network/agents/iflow-mcp-msr2903-mercari-mcp","markdown":"https://wellknown.network/agents/iflow-mcp-msr2903-mercari-mcp/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-msr2903-mercari-mcp","status":"https://wellknown.network/api/v1/agents/iflow-mcp-msr2903-mercari-mcp/status","claim":"https://wellknown.network/agents/iflow-mcp-msr2903-mercari-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-msr2903-mercari-mcp/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-msr2903-mercari-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-msr2903-mercari-mcp/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-msr2903-mercari-mcp/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-msr2903-mercari-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_msr2903-mercari-mcp","summary":"A FastMCP server to search Mercari Japan.","description":"## Demo\n<img src=\"/assets/demo.gif\" width=\"600\" height=\"600\"/>\n\n## Requirements\n\n- Python 3.11 or higher\n- Dependencies as listed in `pyproject.toml`, including:\n  - mcp\n  - mercari\n  - pydantic\n    \n## Pre-setup\n\n1. uv\n   https://docs.astral.sh/uv/getting-started/installation/\n\n2. Microsoft C++ Build Tools (For Windows)\n   https://visualstudio.microsoft.com/visual-cpp-build-tools/\n\n## Setup\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/msr2903/mercari-jp-mcp.git\n   cd mercari-jp-mcp\n   ```\n\n2. Create and activate a virtual environment and install dependencies:\n   ```bash\n   uv venv\n   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate\n   uv pip install -e .\n   ```\n\n## Usage\n\n### Development Mode\n\nYou can test the server with MCP Inspector by running:\n\n```bash\nuv run server.py\n```\n\nYou can also test to input manually the query, exclude keywords, min and max price by running:\n\n```bash\nuv run check_server.py\n```\n\nThis will start the server and allow you to test the available tools.\n\n### Integration with Claude for Desktop\n\nTo integrate this server with Claude for Desktop:\n\n1. Install Claude for Desktop to your local machine.\n2. Install VS Code to your local machine. Then run the following command to open the `claude_desktop_config.json` file:\n   - MacOS: `code ~/Library/Application\\ Support/Claude/claude_desktop_config.json`\n   - Windows: `code $env:AppData\\Claude\\claude_desktop_config.json`\n\n3. Edit the Claude for Desktop config file, located at:\n   - macOS: \n     ```json\n     {\n       \"mcpServers\": {\n         \"mercari\": {\n           \"command\": \"uv\",\n           \"args\": [\n             \"--directory\",\n             \"/ABSOLUTE/PATH/TO/PARENT/FOLDER/mercari-jp-mcp\",\n             \"run\",\n             \"server.py\"\n           ]\n         }\n       }\n     }\n     ```\n   - Windows:\n     ```json\n     {\n       \"mcpServers\": {\n         \"mercari\": {\n           \"command\": \"uv\",\n           \"args\": [\n             \"--directory\",\n             \"C:\\\\ABSOLU…","publisher":null,"homepage":null,"repository":null,"version":"0.1.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_msr2903-mercari-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_msr2903-mercari-mcp","registry":"pypi","observedAt":"2026-09-15T19:23:20.034Z","publishedAt":"2026-02-06T13:33:05.140775Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_msr2903-mercari-mcp","url":"https://pypi.org/project/iflow-mcp_msr2903-mercari-mcp/","firstSeenAt":"2026-09-09T20:24:22.954Z","fetchedAt":"2026-09-15T19:21:58.202Z","normalizedAt":"2026-09-15T19:21:58.202Z"}]},"firstSeenAt":"2026-09-09T20:24:22.954Z","updatedAt":"2026-09-15T19:23:20.034Z"}