FindGoods MCP Server

MCP Server for Japanese anime merchandise wholesale, powered by GoodsMart.

Exposes 54 tools covering the full GoodsMart Shop API — search products, manage cart, place orders, track shipments, and more.

Installation

pip install findgoods-mcp-server

Usage

As MCP Server (for AI clients like Claude Desktop)

Add to your MCP client config:

{
  "mcpServers": {
    "findgoods": {
      "command": "python",
      "args": ["-m", "findgoods_mcp"],
      "env": {
        "WHOLESALE_SHOP_API_URL": "https://api.wholesale.goodsmart.jp"
      }
    }
  }
}

As CLI (token-efficient, for AI agents like Claude Code)

findgoods login --email user@example.com --password xxx
findgoods search-products --keyword "フィギュア"
findgoods add-to-cart --goods-id "xxx" --quantity 6
# after the user confirmed the items, payment method and total (お支払い合計)
findgoods create-order --payment-method bank --expected-total-jpy 11000
findgoods --help

Configuration

The API endpoint defaults to the official API. To change it, set an environment variable:

WHOLESALE_SHOP_API_URL=https://api.wholesale.goodsmart.jp

MCP server mode (python -m findgoods_mcp) also reads a .env file in the working directory, or the file given with --env-file.
CLI mode (findgoods ...) also reads ~/.findgoods/config.env; it does not read a .env in the current directory.
An endpoint other than the official API or localhost prints a warning to stderr, since logins and tokens are sent there.

Shipping

Ships worldwide via international express courier (except sanctioned destinations: North Korea, Iran, Syria, Cuba, Russia, Belarus); import duties are paid by the recipient. Adult items and items restricted by air-transport or import/export rules cannot be shipped outside Japan; overseas shipments can add optional declared-value coverage (declared value = goods amount).

License

MIT

Metadata

Release files for findgoods-mcp-server 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for findgoods-mcp-server 0.3.0
File	Size	Uploaded
findgoods_mcp_server-0.3.0.tar.gz	10.3 MB	Oct 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for findgoods-mcp-server 0.3.0
File	Interpreter	ABI	Platform	Reset
findgoods_mcp_server-0.3.0-py3-none-any.whl 75.6 kB Oct 4, 2026	Python 3	none	any	Details

Total release size: 10.4 MB

Release files / findgoods_mcp_server-0.3.0.tar.gz

Download URL	findgoods_mcp_server-0.3.0.tar.gz
Size	10.3 MB
Tags	Source
SHA-256 checksum How to use checksums	`5a2f3c755d86fa70179cddf2d93a0eba85a3108e507903bfd512452d50f1fc75`
BLAKE2b-256 checksum How to use checksums	`09b87419c51a190d6238611651f18fd5ffaa08c6e5eb5ff3534e2e6808b4861c`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/findgoods-ai/findgoods-mcp-server
Publishing commit: github.com/findgoods-ai/findgoods-mcp-server/tree/72ed0ed7b76198b95693b1a6e35ff4b78eae210b

Workflow

Publishing configuration: github.com/findgoods-ai/findgoods-mcp-server/blob/72ed0ed7b76198b95693b1a6e35ff4b78eae210b/.github/workflows/release.yml
Publishing logs: github.com/findgoods-ai/findgoods-mcp-server/actions/runs/37165082595/attempts/1

Artifact

Subject: findgoods_mcp_server-0.3.0.tar.gz
SHA-256 checksum: 5a2f3c755d86fa70179cddf2d93a0eba85a3108e507903bfd512452d50f1fc75 Verifying attestations

Release files / findgoods_mcp_server-0.3.0-py3-none-any.whl

Download URL	findgoods_mcp_server-0.3.0-py3-none-any.whl
Size	75.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e234b64110d6b3b87d83579d32a3c2fc458c863f675e2ede0480078dd7f655a5`
BLAKE2b-256 checksum How to use checksums	`44d2955152a9214a5aeb8ee99735b729a9287e7858edeffbcc2a36a841f7256e`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/findgoods-ai/findgoods-mcp-server
Publishing commit: github.com/findgoods-ai/findgoods-mcp-server/tree/72ed0ed7b76198b95693b1a6e35ff4b78eae210b

Workflow

Publishing configuration: github.com/findgoods-ai/findgoods-mcp-server/blob/72ed0ed7b76198b95693b1a6e35ff4b78eae210b/.github/workflows/release.yml
Publishing logs: github.com/findgoods-ai/findgoods-mcp-server/actions/runs/37165082595/attempts/1

Artifact

Subject: findgoods_mcp_server-0.3.0-py3-none-any.whl
SHA-256 checksum: e234b64110d6b3b87d83579d32a3c2fc458c863f675e2ede0480078dd7f655a5 Verifying attestations