{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ku5jp38t66zr","handle":"findgoods-mcp-server","url":"https://wellknown.network/agents/findgoods-mcp-server","links":{"self":"https://wellknown.network/agents/findgoods-mcp-server/record.json","html":"https://wellknown.network/agents/findgoods-mcp-server","markdown":"https://wellknown.network/agents/findgoods-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/findgoods-mcp-server","status":"https://wellknown.network/api/v1/agents/findgoods-mcp-server/status","claim":"https://wellknown.network/agents/findgoods-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/findgoods-mcp-server/claim.json","badge":"https://wellknown.network/agents/findgoods-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/findgoods-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/findgoods-mcp-server/tools"},"ard":{"identifier":"urn:air::server:findgoods-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"findgoods-mcp-server","summary":"MCP Server for Japanese anime merchandise wholesale — powered by GoodsMart","description":"# FindGoods MCP Server\n\nMCP Server for Japanese anime merchandise wholesale, powered by [GoodsMart](https://findgoods.ai).\n\nExposes 59 tools for the GoodsMart Shop API — search products, manage the cart, place orders, request and track shipments (with overseas shipping estimates), pay with GM Pay, get business documents (invoices, receipts, delivery notes), and manage the account. A few web-only features (articles, newsletter, product feed subscriptions, order cancellation requests — use an inquiry instead) are not exposed as tools.\n\n## Installation\n\n```bash\npip install findgoods-mcp-server\n```\n\n## Usage\n\n### As MCP Server (for AI clients like Claude Desktop)\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"findgoods\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"findgoods_mcp\"],\n      \"env\": {\n        \"WHOLESALE_SHOP_API_URL\": \"https://api.wholesale.goodsmart.jp\"\n      }\n    }\n  }\n}\n```\n\n### As CLI (token-efficient, for AI agents like Claude Code)\n\n```bash\nfindgoods login --email user@example.com --password xxx\nfindgoods search-products --keyword \"フィギュア\"\nfindgoods add-to-cart --goods-id \"xxx\" --quantity 6\n# after the user confirmed the items, payment method and total (お支払い合計)\nfindgoods create-order --payment-method bank --expected-total-jpy 11000\nfindgoods --help\n```\n\n## Configuration\n\nThe API endpoint defaults to the official API. To change it, set an environment variable:\n\n```\nWHOLESALE_SHOP_API_URL=https://api.wholesale.goodsmart.jp\n```\n\n- MCP server mode over stdio (`python -m findgoods_mcp`) also reads `~/.findgoods/config.env`, or only the file given with `--env-file`; it does not read a `.env` in the working directory.\n- MCP server mode over HTTP (`--transport streamable-http` / `sse`) also reads a `.env` file in the working directory, or only the file given with `--env-file`.\n- CLI mode (`findgoods ...`) also reads `~/.findgoods/config.env`; it does not read a `.env` in the current directory.\n- An endpoint other than the official API…","publisher":null,"homepage":"https://findgoods.ai","repository":"https://github.com/findgoods-ai/findgoods-mcp-server","version":"0.4.3","license":"MIT","protocols":["mcp"],"tags":["anime","b2b","japan","mcp","wholesale"],"pricing":null,"endpoints":[{"url":"pypi:findgoods-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"documents.invoice-processing","name":"Invoice Processing","confidence":1,"provenance":"derived"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":0.802,"provenance":"derived"}],"categories":["commerce","documents"],"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":"findgoods-mcp-server","registry":"pypi","observedAt":"2026-11-09T05:24:35.673Z","publishedAt":"2026-10-16T05:04:50.685269Z","latestVersion":"0.4.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"findgoods-mcp-server","url":"https://pypi.org/project/findgoods-mcp-server/","firstSeenAt":"2026-09-09T15:22:58.840Z","fetchedAt":"2026-11-09T05:23:02.896Z","normalizedAt":"2026-11-09T05:23:02.896Z"}]},"firstSeenAt":"2026-09-09T15:22:58.840Z","updatedAt":"2026-11-09T05:24:35.673Z"}