MCP Connector for Sam's Club

An MCP (Model Context Protocol) server that exposes Sam's Club product search, store locator, and membership information as tools for AI assistants.

Tools

search_products

Search Sam's Club products by keyword, with optional category filtering and result count control.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | query | string | Yes | Search term (e.g. "olive oil", "TV", "laundry detergent") | | category | string | No | Filter by category: Electronics, Grocery, Household, Meat & Seafood, Appliances, Outdoor | | maxResults | number | No | Max results to return (default: 10, max: 15) |

Example response fields: id, name, category, price, unit, availability, rating, reviews

find_clubs

Find Sam's Club warehouse locations near a zip code or city.

Parameters:

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | location | string | Yes | Zip code (e.g. "72712") or city/state (e.g. "Bentonville, AR") | | radius | number | No | Search radius in miles (default: 25) |

Example response fields: club id, name, address, phone, hours, services, distanceMiles

get_membership_info

Returns Sam's Club membership tiers, annual fees, and benefits. Takes no parameters.

Response includes: membership types (standard and Plus), annual fees, benefits lists, add-on pricing, free trial details, and contact information.

Installation

npm install
npm run build

Usage

Run directly

node dist/index.js

Configure in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "samsclub": {
      "command": "node",
      "args": ["/path/to/mcp-samsclub/dist/index.js"]
    }
  }
}

Or if installed globally via npm:

{
  "mcpServers": {
    "samsclub": {
      "command": "mcp-samsclub"
    }
  }
}

Development

# Install dependencies
npm install

# Build
npm run build

# Pack for distribution
npm pack

Notes

This connector uses realistic mock data and does not make live requests to Sam's Club servers. It is intended for development, testing, and demonstration purposes.

License

MIT