home / mcp / mcp shop mcp server

MCP Shop MCP Server

Provides MCP-based authentication and order actions for a secure web shop via MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "doodlydan-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3000/mcp"
      ],
      "env": {
        "WORKOS_API_KEY": "YOUR_WORKOS_API_KEY"
      }
    }
  }
}

You run an MCP server that lets clients connect, authenticate, and perform actions through a secure, model-driven protocol. This enables you to expose your shop’s MCP-based capabilities—like authenticating users, placing orders, and viewing order details—to MCP clients in a consistent, scalable way.

How to use

To use the MCP server, connect your MCP client to the local development server, authenticate with WorkOS AuthKit, and then perform shop-related actions such as ordering t-shirts and viewing order details if you have admin access.

Connect to the MCP server from your MCP client by configuring the MCP to point at your local host and the MCP endpoint. A typical configuration points to the running server at the local address and its /mcp endpoint.

{
  "mcpServers": {
    "mcp.shop": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
    }
  }
}

How to install

Follow these steps to set up and run the MCP server locally.

Prerequisites: Node.js (latest LTS recommended), Redis service (e.g., Upstash), and a WorkOS account with AuthKit configured.

1. Install the required package manager if you do not have it installed (example uses pnpm):

# install pnpm if needed
npm i -g pnpm

2. Install dependencies for the project (run from the project root):

pnpm install

3. Create and configure environment variables from a template:

cp .env.example .env.local

4. Start the development server so you can access the website and the MCP endpoint at /mcp:

pnpm dev

5. Visit the shop website and MCP endpoint locally. The website runs at http://localhost:3000 and the MCP server is available at /mcp on that host.

Additional notes

The server supports connecting via an MCP client by running an MCP command that starts a remote host pointing to the local MCP endpoint. You can also configure your client to load the mcp-remote integration for http-based MCP communication.

Connecting to MCP

If you want to connect your MCP client to the development server, you can use this configuration in your MCP client config file to point to the local server:

{
  "mcpServers": {
    "mcp.shop": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
    }
  }
}

Available tools

connect

Establishes a connection between an MCP client and the MCP server, enabling secure communication and session setup.

authenticate

Authenticates a user via WorkOS AuthKit to grant access to MCP-protected actions.

order_tshirt

Places an order for a t-shirt using MCP tools and tracks the order through to completion.

view_order

Allows admins to view order details and related information.