# WebMCP Demo Store

> WebMCP Demo Store is an open-source MCP server for e-commerce. Demo MCP store comparing agent tool calls against DOM scraping on the same catalog. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, CLI, self-hosted, Chrome extension
- **Website:** https://demowithmcp.converso.work/launch.html
- **Repository:** https://github.com/kamatanuj/webmcp
- **MCP Registry name:** io.github.kamatanuj/webmcp-store
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says this is a single-file store server that runs in two modes: a plain website that agents must parse as full HTML pages, and a WebMCP mode that exposes the same catalog and cart through MCP tool calls over HTTP and Chrome's document.modelContext. Its purpose is to measure how the two delivery methods differ for agents.

The repository reports a benchmark on a 150-product catalog with identical shopping tasks, citing 79% fewer action bytes and 42% fewer input tokens in WebMCP mode, with 8 of 8 tasks correct in both modes. It also notes that DOM mode performed better on smaller catalogs, so the advantage depends on catalog size.

The server is stdlib-only Python with no dependencies, and the README includes a Chrome 154 test where the five-tool store contract (search, add to cart, get cart, checkout) was registered and called through the native API. It is aimed at developers evaluating agent-ready web delivery rather than shoppers.

## Features

- **Dual delivery modes:** The same store runs as a conventional website or as an MCP endpoint, selected by an environment flag.
- **MCP over HTTP:** Exposes catalog and cart operations at a /mcp endpoint with .well-known discovery.
- **Chrome-native WebMCP tools:** Registers store tools through document.modelContext so Chrome clients can discover and execute them.
- **Reproducible benchmark harness:** Includes scripts for DOM-mode and LLM-token comparisons plus report generation from stored results.
- **No-dependency server:** Runs with the Python standard library, so it can be started locally without installing packages.

## Good for

- Compare token and byte costs of agent access via MCP versus scraping a web page
- Prototype an MCP-enabled storefront to test agent shopping flows
- Evaluate whether WebMCP tool contracts work with Chrome's native client API
- Reproduce the published 150-product benchmark locally

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http webmcp-store https://demowithmcp.converso.work/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://demowithmcp.converso.work/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "webmcp-store": {
      "url": "https://demowithmcp.converso.work/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "webmcp-store": {
      "type": "http",
      "url": "https://demowithmcp.converso.work/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "webmcp-store": {
      "serverUrl": "https://demowithmcp.converso.work/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "webmcp-store": {
      "type": "http",
      "url": "https://demowithmcp.converso.work/mcp"
    }
  }
}
```

## Tools

- `search_products`: Searches the store catalog.
- `add_to_cart`: Adds a product to the cart.
- `get_cart`: Returns current cart contents.
- `checkout`: Places an order from the cart.

## FAQ

### How do I run the server locally?

The README gives python3 server.py for plain mode on port 9501, and MCP=1 PORT=9502 python3 server.py for WebMCP mode with the /mcp endpoint.

### What dependencies does it need?

It is stdlib-only, using http.server, json, uuid and threading, so no pip install is required.

### What license is it released under?

The README states the project is licensed under MIT.

### What were the benchmark results?

The README reports 79% less action bytes, 42% fewer input tokens, and 8 of 8 tasks correct in both modes on a 150-product catalog.

### Is WebMCP Demo Store free?

Yes. WebMCP Demo Store is open source, so you can use and self-host it for free.

### How do I add WebMCP Demo Store to Claude Code?

Run this command in your terminal: claude mcp add --transport http webmcp-store https://demowithmcp.converso.work/mcp

### What are the best alternatives to WebMCP Demo Store?

The closest alternatives to WebMCP Demo Store are MCP CPG Agent Protocols, Sample Shop MCP server, Ecommerce Mcp, Chrome DevTools MCP and OneTool MCP.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [MCP CPG Agent Protocols](https://ai-powered.com/mcp/mcp-cpg-agent-protocols): MCP CPG Agent Protocols is an MCP server for developer tools.
- [Sample Shop MCP server](https://ai-powered.com/mcp/sample-shop-mcp-server): Sample Shop MCP server is an open-source MCP server for developer tools.
- [Ecommerce Mcp](https://ai-powered.com/mcp/ecommerce-mcp): Ecommerce Mcp is a freemium MCP server for e-commerce.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-4): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [OneTool MCP](https://ai-powered.com/mcp/onetool-mcp): OneTool MCP is an open-source MCP server for developer tools.
- [MyOnlineStore MCP by usefulapi](https://ai-powered.com/mcp/myonlinestore-mcp-by-usefulapi): MyOnlineStore MCP by usefulapi is a freemium MCP server for e-commerce.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mweo0sk4): MCP Server is an MCP server for developer tools.
- [Universal Data API](https://ai-powered.com/mcp/universal-data-api): Universal Data API is a paid MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/webmcp-demo-store
