Sam'S Club Sponsored Ads APIs MCP Server

MCP server for Sam's Club Sponsored Ads APIs

Local serverstdioPython

What is the Sam'S Club Sponsored Ads APIs MCP server?

MCP server for Sam's Club Sponsored Ads APIs. The sam's club sponsored ads apis mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 7 defined tools rather than through you.

What it actually does

  • Spec-driven discovery — — list/describe endpoints from a bundled OpenAPI spec, refreshable at runtime
  • Any endpoint — — call by operation id or raw method+path (raw path reaches endpoints not yet in the spec); no code changes when APIs evolve
  • Multi-region, multi-environment (production + sandbox) via config file
  • Per-request RSA-SHA256 signing with automatic header construction
  • Large responses truncated with full data available via MCP resource URI

Adding it to your client

The server ships on npm as @modelcontextprotocol/inspector, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Its toolset

Everything the assistant can do here goes through one of these:

  • list_endpoints — List operations from the bundled OpenAPI spec for an ad_type, with optional filters
  • describe_endpoint — Return one operation plus the components.schemas reachable from it (its $ref closure), so request bodies and responses can be built without the full
  • call_endpoint — Execute any Sam's Club Sponsored Ads API endpoint. Identify it by operation_id, or by raw method + path. Raw method+path also reaches endpoints not
  • refresh_specs — Re-fetch the bundled OpenAPI spec from its committed source_url into a user cache (~/.cache/mcp-samsclub-ads/specs/) that takes precedence over the
  • Cursor — The Cursor tool exposed by this server
  • Codex — The Codex tool exposed by this server
  • OpenCode — The OpenCode tool exposed by this server

Configuration

  • Python 3.13+ - Sam's Club Partner credentials (consumer ID, RSA key pair, bearer token) — see Status & blocker

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the sam's club sponsored ads apis mcp server does with a few real requests.

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Sam'S Club Sponsored Ads APIs's toolset — list_endpoints, describe_endpoint, call_endpoint and 4 more — is a fair guide to whether it matches your workflow. It is maintained by alyiox; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Sam'S Club Sponsored Ads APIs's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
list_endpointsList operations from the bundled OpenAPI spec for an ad_type, with optional filters.
describe_endpointReturn one operation plus the components.schemas reachable from it (its $ref closure), so request bodies and responses can be built without the full spec.
call_endpointExecute any Sam's Club Sponsored Ads API endpoint. Identify it by operation_id, or by raw method + path. Raw method+path also reaches endpoints not yet in the bundled spec. The server handles RSA-SHA256 signing.
refresh_specsRe-fetch the bundled OpenAPI spec from its committed source_url into a user cache (~/.cache/mcp-samsclub-ads/specs/) that takes precedence over the bundled copy — ship fixes without a release.
CursorThe Cursor tool exposed by this server.
CodexThe Codex tool exposed by this server.
OpenCodeThe OpenCode tool exposed by this server.

How to install the Sam'S Club Sponsored Ads APIs MCP server

{
  "mcpServers": {
    "samsclub-ads": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/inspector"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Python 3.13+ - Sam's Club Partner credentials (consumer ID, RSA key pair, bearer token) — see Status & blocker

Example prompts to try

  • Use Sam'S Club Sponsored Ads APIs to list endpoints.
  • Use Sam'S Club Sponsored Ads APIs to describe endpoint.
  • Use Sam'S Club Sponsored Ads APIs to call endpoint.

Frequently asked questions

It connects Sam'S Club Sponsored Ads APIs to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (list_endpoints, describe_endpoint, call_endpoint, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Sam'S Club Sponsored Ads APIs directly.