mcp-samsclub-ads

# Run directly with uvx (no clone needed) npx -y @modelcontextprotocol/inspector uvx mcp-samsclub-ads

# Or run from source git clone https://github.com/alyiox/mcp-samsclub-ads.git cd mcp-samsclub-ads uv sync npx -y @modelcontextprotocol/inspector uv run mcp-samsclub-ads

The config file lives under your home directory at~/.config/mcp-samsclub-ads/config.json.

Windows note:~maps to%USERPROFILE%(typicallyC:\Users\<you>), so the full path is%USERPROFILE%\.config\mcp-samsclub-ads\config.json.

1. Create the config directory and copy the example

# Unix-like (macOS, Linux, WSL, …) mkdir -p ~/.config/mcp-samsclub-ads/keys/us cp config.example.json ~/.config/mcp-samsclub-ads/config.json

# Windows (PowerShell) New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\mcp-samsclub-ads\keys\us" Copy-Item config.example.json "$env:USERPROFILE\.config\mcp-samsclub-ads\config.json"

2. Edit~/.config/mcp-samsclub-ads/config.json

{ "response_cache_ttl": 3600, "truncate_threshold": 1024, "regions": { "US": { "production": { "consumer_id": "your-consumer-id", "private_key": "./keys/us/prod.pem", "private_key_version": "1", "bearer_token": "your-bearer-token", "base_urls": { "sponsored": "https://developer.api.us.walmart.com/api-proxy/service/sp/api-sams/v1" } }, "sandbox": { "consumer_id": "your-sandbox-consumer-id", "private_key": "./keys/us/sandbox.pem", "private_key_version": "1", "bearer_token": "your-sandbox-bearer-token", "base_urls": { "sponsored": "https://developer.api.us.stg.walmart.com/api-proxy/service/sp/api-sams/v1" } } } } }

3. Place your RSA private key PEM files in~/.config/mcp-samsclub-ads/keys/

Key paths in the config are resolved relative to the config directory, so./keys/us/prod.pemresolves to~/.config/mcp-samsclub-ads/keys/us/prod.pem.

Each request is signed withWM_CONSUMER.ID,WM_SEC.AUTH_SIGNATURE(Base64 RSA-SHA256),WM_SEC.KEY_VERSION, andWM_CONSUMER.INTIMESTAMP(Unix epoch ms), plusAuthorization: Bearer <token>— all injected automatically by the client.

- Production:https://developer.api.us.walmart.com/api-proxy/service/sp/api-sams/v1
- Sandbox:https://developer.api.us.stg.walmart.com/api-proxy/service/sp/api-sams/v1

Paths in the spec begin/api/v1/...(or/api/v2/...), so the effective URL is<base_url>/api/v1/<resource>.

List operations from the bundled OpenAPI spec for anad_type, with optional filters.

Return one operation plus thecomponents.schemasreachable from it (its$refclosure), so request bodies and responses can be built without the full spec.

Execute any Sam's Club Sponsored Ads API endpoint. Identify it byoperation_id, or by rawmethod+path. Raw method+path also reaches endpoints not yet in the bundled spec. The server handles RSA-SHA256 signing.