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

MCP Connector for Sam's Club