Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-costco Search for Kirkland olive oil and add two to my cart"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server connector for Costco — search products, manage cart, check membership, find warehouses, and place orders via browser automation.
Search Products — Search Costco.com by keyword, category, or brand with price filters
Product Details — Get full product info, price, availability, and item number
Cart Management — Add items, view cart, update quantities, remove items
Delivery Options — Check home delivery and warehouse pickup availability
Checkout — Preview and place orders (with confirmation step)
Order History — View past orders with status
Order Tracking — Track shipment status and estimated delivery
Membership — Check membership type, number, and renewal date
Warehouse Locations — Find nearby Costco warehouses by ZIP or city
Warehouse Stock — Check in-store availability at specific locations
Related MCP server: MCP Shop Server
Node.js 18+
A Costco membership account
Playwright browsers installed
npx playwright install chromiumAdd to your claude_desktop_config.json:
{
"mcpServers": {
"costco": {
"command": "npx",
"args": ["@striderlabs/mcp-costco"]
}
}
}Tool | Description |
| Check authentication status and session info |
| Authenticate with email and password |
| Clear session and stored cookies |
Tool | Description |
| Search by name, category, or brand |
| Get full product info, price, availability |
| Add item to cart by URL or item number |
| View cart contents and totals |
| Change quantities or remove items (qty=0 removes) |
Tool | Description |
| Check delivery/pickup availability for a ZIP |
| Choose home delivery or warehouse pickup |
| Preview (confirm=false) or place order (confirm=true) |
Tool | Description |
| View order history |
| Track delivery status by order number |
Tool | Description |
| Check membership type, number, and renewal date |
| Find nearby warehouses by ZIP or city |
| Check in-warehouse availability |
# Login
login(email="you@example.com", password="yourpassword")
# Search for items
search_products(query="kirkland olive oil", limit=5)
# Get product details
get_product_details(item_number="1234567")
# Add to cart
add_to_cart(item_number="1234567", quantity=2)
# Preview checkout
checkout(confirm=false)
# Place order
checkout(confirm=true)
# Check membership
get_membership()
# Find nearby warehouses
get_warehouse_locations(zip_code="94105", limit=3)Credentials can also be passed via environment variables (used as defaults if login tool is not called):
Variable | Description |
| Costco account email |
| Costco account password |
Sessions are stored in ~/.striderlabs/costco/ and persist across runs. You only need to log in once per machine.
By default, the browser runs headless. To debug, pass headless=false to the login tool to see the browser window.
Strider Labs — Building AI agent infrastructure.
MIT
Add a Costco product to the cart
Inputs: url, item_number, quantity.
Preview or complete a Costco order. Use confirm=false to preview first.
Inputs: confirm.
Check in-warehouse availability of a product at a specific Costco location
Inputs: item_number, url, zip_code.
Check delivery and warehouse pickup availability for cart items or a specific product
Inputs: zip_code (required), item_number.
Check Costco membership status, type, and renewal date
Inputs: no named parameters.
View Costco order history
Inputs: limit.
Get detailed product information including price, description, and availability
Inputs: url, item_number.
Find nearby Costco warehouses by ZIP code or city
Inputs: zip_code, city, state, limit.
Authenticate with Costco account using email and password via browser automation
Inputs: email (required), password (required), headless.
Clear Costco session and stored cookies
Inputs: no named parameters.
Search Costco products by name, category, or brand
Inputs: query (required), category, min_price, max_price, +2 more.
Choose delivery method — home delivery or warehouse pickup
Inputs: method (required), warehouse_id, zip_code.
Check Costco authentication status and session info
Inputs: no named parameters.
Track a Costco order delivery status
Inputs: order_number (required).
Update item quantities or remove items from the Costco cart
Inputs: item_number (required), quantity (required).
View current Costco cart contents and totals
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 16 tools
Each tool has a clearly distinct purpose with no significant overlap. For example, 'add_to_cart' and 'update_cart' handle different cart operations, while 'check_warehouse_stock' and 'get_delivery_options' address separate availability concerns. The descriptions reinforce these distinctions, making tool selection straightforward for an agent.
All tools follow a consistent verb_noun naming pattern, such as 'add_to_cart', 'get_product_details', and 'track_order'. This uniformity enhances readability and predictability across the set, with no deviations in style or convention.
With 16 tools, the server is well-scoped for a Costco e-commerce domain, covering authentication, product search, cart management, order processing, and membership functions. Each tool serves a specific role, avoiding bloat while providing comprehensive coverage for typical shopping workflows.
The toolset offers complete coverage for the Costco shopping domain, including CRUD operations for cart items, order lifecycle from checkout to tracking, product discovery, and account management. No obvious gaps exist; agents can perform end-to-end tasks like searching, adding to cart, checking out, and tracking orders seamlessly.
Search live store shelves, verify delivery windows, and run instant AI agent checkouts.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Automate any website: discover, run and create browser scripts that work behind logins.