About Mcp.shop
Mcp.shop is an MCP server published by workos in the Commerce category: mcp.shop storefront/app for MCP Night.
The repository has 106 stars and 25 forks, with the last commit 2 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/workos/mcp.shopThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Mcp.shop
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 15 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
README
Overview
This project demonstrates how to use AuthKit with MCP to create a secure web shop where users can:
- Connect to an MCP server
- Authenticate via AuthKit
- Order t-shirts using MCP tools
- View order details (admin users only)
Architecture
The application is built on:
- Next.js B2B Starter Kit for the website
- Vercel MCP Adapter for MCP integration
- WorkOS AuthKit with MCP for authentication
Key components:
- Authentication logic:
lib/with-authkit.ts - Client registration:
app/.well-known/ - MCP implementation:
app/[transport]/route.ts
Prerequisites
- Node.js (latest LTS version recommended)
- WorkOS account with AuthKit configured
- Redis service (e.g., Upstash)
Setup
-
Clone the repository
-
Install dependencies:
pnpm install -
Configure environment variables:
Copy
.env.exampleto.env.localand set each environment variable appropriately.Note:
- You can find your WorkOS credentials in the WorkOS dashboard.
- Make sure to set your redirect URI (
http://localhost:3000/callbackfor local development orhttps://<deployed-url>/callbackfor production) in the dashboard. - Make sure you have enabled Dynamic Client Registration on the dashboard. It should be under Developer -> Application -> Configuration page on the dashboard
-
Start the development server:
pnpm devThe application will be available at:
- Website: http://localhost:3000
- MCP Server:
/mcp
Connecting to MCP
To connect your chat client to the development server, add the following configuration to your MCP config file (e.g., .cursor/mcp.json):
{
"mcpServers": {
"mcp.shop": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
}
}
}
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
README fetched from the repository 15 hours ago. The original is authoritative.