OPEN SOURCE · MIT · v0.2.0

Your webshop, on speaking terms with Claude.

An MCP server that gives AI assistants 38 tools for your ShopWired store — products, orders, customers and configuration — wrapped in rate limits, confirmation guards and a circuit breaker.

⬇ Download zip View on GitHub ↗

unzip → bash install.sh → done · versioned bundles on the releases page

No plugins needed Keys stay on your machine 35 tests

claude — shopwired session

show my top-selling products11 product tools

how many orders this week?7 order tools

create code SAVE10, 10% offvoucher created ✓

set stock for #1234 to 50stock updated ✓

delete product #999needs confirm=True

TOTAL TOOLS38

"Show me my top-selling products" "How many orders came in this week?" "Create a 10% discount code called SAVE10" "Update stock for product 1234 to 50 units" "What shipping zones do I have configured?" "List customers and their order counts" "Show me my top-selling products" "How many orders came in this week?" "Create a 10% discount code called SAVE10" "Update stock for product 1234 to 50 units" "What shipping zones do I have configured?" "List customers and their order counts"

One powerful integration

Everything on the shelf, nothing off the books.

Every tool declares MCP annotations (read-only, destructive, idempotent) so your AI client knows what's safe to auto-approve — and every delete demands explicit confirmation.

🛍️11 tools

Products

Search, list, create and update — stock levels, variations, images. Pence-to-pounds handled correctly.

📦7 tools

Orders

List, search, update status with optional customer notification, add internal comments.

💛4 tools

Customers

Look up, count and create customer records — with email validation built in.

🗂️16 tools

Store configuration

Categories, brands, vouchers, gift cards, shipping zones, webhooks (HTTPS-only), payment methods.

🛡️built in

Reliability layer

Leaky-bucket rate limiter matched to ShopWired's API limits, circuit breaker, response cache, retry with backoff.

☁️optional

Remote mode

Deploy as a hosted MCP server: bearer-token auth, /health probes, Dockerfile for Cloud Run, Render or any VPS.

Get started

Two minutes from zip to first prompt.

Get the code

Download the zip above, or clone from GitHub.

git clone https://github.com/
  mcmespinaa/shopwired-mcp-server.git

Run the installer

Sets up Python, asks for your ShopWired API key & secret, registers with Claude Code.

cd shopwired-mcp-server
bash install.sh  # Windows: install.bat

Ask your store something

Restart Claude and try:

"How many orders came in
 this week?"

works with Claude Code Claude Desktop Claude Cowork Cursor Windsurf any MCP client

Included free

Ten skills that teach the judgment — not just the tools.

The server gives your assistant hands; the bundled skills library gives it retail sense — how variation stock really works, when a price change needs a promotion guard, what to check before touching a live store.

store-intelligence-core product-catalog-quality inventory-decision-engine pricing-promotion-guard order-lifecycle-management customer-segment-intelligence b2b-wholesale-routing multi-channel-sync-governance onboarding-store-setup reporting-and-insight-framing