# CLISHOP > Order anything from your terminal — search, buy, track, and manage via MCP tools. - **Type:** MCP server - **Install:** `agentstack add mcp-davooxbv2-clishop` - **Verified:** Pending review - **Seller:** [DavooxBv2](https://agentstack.voostack.com/s/davooxbv2) - **Installs:** 0 - **Latest version:** 0.2.1 - **License:** MIT - **Upstream author:** [DavooxBv2](https://github.com/DavooxBv2) - **Source:** https://github.com/DavooxBv2/CLISHOP - **Website:** https://clishop.ai/ ## Install ```sh agentstack add mcp-davooxbv2-clishop ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About CLISHOP Order anything from your terminal. Built for AI agents and humans. --- CLISHOP is an open-source CLI that lets AI agents and humans search for products across multiple stores, compare prices, and place real orders — all from the terminal. Anyone can sell on CLISHOP using a [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE). ## Works with ## Highlights - One query searches every store in the network. Results are filtered to what actually ships to your address. - Set spending caps per order, require email confirmation before anything ships, or let it go through automatically — your call. - Ships as a native [MCP server](https://modelcontextprotocol.io/) with 46 tools. Works with VS Code Copilot, Claude, Cursor, Windsurf, and anything else that speaks MCP. - Can't find what you need? Post an advertise request and let vendors compete to fulfill it. - Support tickets, product reviews, store reviews — all from the terminal. - Anyone can sell on CLISHOP by deploying a [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE). No website needed. --- ## Install Requires **Node.js ≥ 18**. Works on macOS, Windows, and Linux/WSL. ```bash npm install -g clishop ``` This gives you two commands: `clishop` (the CLI) and `clishop-mcp` (the MCP server for AI agents). ### OpenClaw Once the ClawHub package is published, install CLISHOP into an OpenClaw workspace with: ```bash openclaw plugins install clawhub:clishop ``` The bundle exposes the CLISHOP skill under `skills/clishop/SKILL.md` and merges the packaged MCP defaults from `.mcp.json` so OpenClaw can launch the bundled CLISHOP MCP runtime locally without fetching npm code at startup. ### Linux / WSL CLISHOP works out of the box on Linux and WSL. On systems without a native keychain, tokens are stored in a local file (`~/.config/clishop/auth.json`) with restricted permissions. For native keychain support (optional): ```bash sudo apt install libsecret-1-0 ``` Run `clishop doctor` to check your system's compatibility. ### From source ```bash git clone https://github.com/DavooxBv2/CLISHOP.git cd CLISHOP npm install npm run build npm link ``` ## Quick Start You can create your account on [clishop.ai](https://clishop.ai) or do everything from the CLI. ### Setup Setup only needs an email address. Search first, then add your address and payment method when you're ready to buy. For OpenClaw, MCP clients, Claude-style shells, and other tool runners, use: ```bash clishop setup start --email user@example.com --json ``` `setup start` returns immediately with account-ready status and stores auth locally. In OpenClaw, prefer the installed CLISHOP MCP tools over CLI shell commands. For address management, the intended flow is to call `list_addresses` first, then `add_address` non-interactively with any known fields, and ask the user only for missing required address fields (`label`, `firstName`, `lastName`, `line1`, `city`, `postalCode`, `country`). For payments, use `add_payment_method` to generate a secure setup link for the human, then check `list_payment_methods` after the human completes the web flow. The agent should never ask for raw card details in chat. - Search products right away with `clishop search ` - Add a shipping address later with `clishop address add` - Add a payment method later with `clishop payment add` After setup is complete, add a shipping address and start ordering: ``` $ clishop search "wireless headphones" 🔍 Search results for "wireless headphones" 1 Sony WH-1000XM5 $278.00 SUPERSTORE · ★ 8.1 · Free shipping · 3-5 days 2 JBL Tune 770NC Wireless $79.95 EveryMarket · ★ 7.9 · $5.99 shipping · 5-8 days ``` ``` $ clishop info 1 Sony WH-1000XM5 ───────────────────────────────────── Price: $278.00 Store: SUPERSTORE (★ 8.1) Shipping: Free · 3-5 business days Returns: 30-day free returns In stock: Yes Industry-leading noise cancellation with Auto NC Optimizer. 30-hour battery life. Multipoint connection for two devices. ``` ```bash clishop buy 1 ``` > **Tip:** use result numbers from a search anywhere — `clishop info 1 2 3` or `clishop buy 2`. ### Diagnostics If something isn't working, run: ```bash clishop doctor ``` This checks keychain availability, token storage, authentication status, and API connectivity. --- ## Architecture ``` ┌─────────────────────────────┐ │ AI Agent / Script / Human │ └──────────────┬──────────────┘ │ ┌───────▼───────┐ │ CLISHOP CLI │ ← this repo │ (Node.js) │ └───────┬───────┘ │ HTTPS ┌───────▼───────┐ │ CLISHOP API │ ← backend (Vercel) └───────┬───────┘ │ ┌──────────┼──────────┐ ▼ ▼ ▼ Store A Store B Store C ← vendor Dark Stores ``` --- ## Sell on CLISHOP You can run your own store with the [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE) template. Define your catalog, shipping rules, and pricing in YAML, deploy to Vercel, and you're live. No website needed. --- ## Development ```bash git clone https://github.com/DavooxBv2/CLISHOP.git cd CLISHOP && npm install npm run dev -- search "headphones" # Dev mode (no build needed) npm run build # Production build npm run lint # Type-check ``` --- ## MCP Server CLISHOP ships as a native MCP server with 46 tools. Any MCP-compatible client gets shopping capabilities out of the box. ```bash clishop-mcp # If installed globally node ./dist/mcp.js # From the installed package directory ``` The MCP onboarding tools now follow the same email-first model: - `setup` creates the account immediately from the email address - `setup_status` remains available only for legacy setup IDs See the [MCP setup guides](https://clishop.ai/docs#mcp-overview) for VS Code, Claude Desktop, Cursor, and Windsurf configuration. --- ## Docs Full command reference, agent configuration, search filters, and more: **[→ clishop.ai/docs](https://clishop.ai/docs)** --- ## Links - 🌐 [clishop.ai](https://clishop.ai) - 📖 [Docs](https://clishop.ai/docs) - 💬 [Discord](https://discord.gg/vwXMbzD4bx) - 🏪 [Dark Store](https://github.com/DavooxBv2/CLISHOP-DARKSTORE) ## License [MIT](LICENSE) ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [DavooxBv2](https://github.com/DavooxBv2) - **Source:** [DavooxBv2/CLISHOP](https://github.com/DavooxBv2/CLISHOP) - **License:** MIT - **Homepage:** https://clishop.ai/ Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Versions - **0.2.1** — security scan: pending review — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-davooxbv2-clishop - Seller: https://agentstack.voostack.com/s/davooxbv2 - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.