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