Log inSubmit server
Swell MCP logo

Swell MCP

Connects AI assistants to Swell for product, inventory, order, and customer operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Swell MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "swell-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "swell-mcp"
      ],
      "env": {
        "SWELL_STORE_ID": "YOUR_VALUE_HERE",
        "SWELL_SECRET_KEY": "YOUR_VALUE_HERE",
        "DEBUG": "YOUR_VALUE_HERE",
        "TRANSPORT_MODE": "YOUR_VALUE_HERE",
        "PORT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 14 tools correctly (6d ago).

Overview

Swell MCP MCP server connects AI assistants to Swell stores through MCP tools for catalog, inventory, order, and customer data. It uses Swell API credentials and supports STDIO and HTTP transport modes. Reach for it when an agent needs to inspect products, check stock, search customers, review orders, or update order statuses from a Swell store. Node.js 18 or newer is required.

Use cases

  • List and filter products in a Swell catalog
  • Check inventory before answering product questions
  • Review orders by status or date
  • Update an order's status
  • Search customer records

Key features

  • Product listing, retrieval, and search
  • Inventory level checks
  • Filtered order listing and detail retrieval
  • Order status updates
  • Customer listing and search
  • STDIO and HTTP transport modes

Tools14

What Swell MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

7/7 checks healthy over the last 40d

What it can do

From the 14 tools this server returned when we ran it; 14 declare their own safety hints.

Can delete or modify data · 1Read-only tools · 13
Network at startup3 connections
Files written at startup1
Install scriptsprepare, postinstall
npm provenanceSigned build
Package age369 days
Maintainers2

Observed 2026-10-16 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · swell-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads169Package downloads in the last 30 days.
Last commit5mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed14Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Swell MCP works

What Swell MCP MCP server does

Swell MCP MCP server exposes selected Swell e-commerce operations as MCP tools for AI assistants. The integration covers four main areas: product catalog access, inventory checks, order lookup and status changes, and customer search and retrieval.

Product tools can list records with filters and pagination, retrieve a specific product, search products using multiple criteria, and inspect inventory levels. Order tools list filtered orders, return order details, and update an order's status. Customer tools list customers with search options, retrieve an individual customer, and search customers using multiple criteria.

Responses are formatted as structured Markdown output. The implementation also reports API and validation failures using structured error handling with Swell-specific context.

How it works

The server communicates with Swell through the Swell Node SDK and exposes the resulting operations through MCP. It is implemented in TypeScript and validates tool inputs with Zod schemas. Its architecture separates the command-line layer, MCP tools, controllers, services, and utility code.

Two transport modes are available. STDIO is suitable for desktop and editor clients that launch the server as a local process. HTTP mode is available for web-oriented use and can run on a configured port. The documented standard launch command uses npx swell-mcp.

The server requires a Swell store identifier and private API credential. These values identify the store and authorize access to its API. The secret key should be the backend or administrative key rather than a public key.

Setup and configuration

Install or launch Swell MCP MCP server from an MCP client using Node.js 18 or later. A typical STDIO configuration starts npx with the swell-mcp package and passes credentials through environment variables.

Required variables are:

  • SWELL_STORE_ID: the Swell store identifier.
  • SWELL_SECRET_KEY: the Swell secret or private API key.

DEBUG is optional. Set it to true for detailed logging and raw JSON responses; the example configuration uses false. For HTTP operation, set TRANSPORT_MODE=http and optionally choose a PORT, such as 3001.

Credentials are obtained in the Swell dashboard under Developer and API Keys. Cursor can use its MCP settings, while VS Code can also register the server through its CLI.

Tools and capabilities

Available MCP tools include:

  • swell_list_products for filtered, paginated product lists.
  • swell_get_product for detailed product records.
  • swell_search_products for multi-criteria product searches.
  • swell_check_inventory for product stock levels.
  • swell_list_orders for filtered order lists.
  • swell_get_order for detailed order records.
  • swell_update_order_status for changing order status.
  • swell_list_customers for customer lists with search options.
  • swell_get_customer for individual customer details.
  • swell_search_customers for multi-criteria customer searches.

These tools support tasks such as finding active products, reviewing pending orders with date filters, checking stock, and locating customer records.

Limitations and notes

The documented tool set focuses on reading products, inventory, orders, and customers, plus updating order status.

Access depends on valid Swell credentials and the permissions associated with the supplied private key. HTTP settings are configurable, but the material does not specify authentication or deployment controls for an HTTP deployment. Testing, linting, formatting, release tooling, and MCP Inspector support are included in the project, but no performance or availability guarantees are stated.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Swell MCP

Swell MCP is an MCP server that connects AI assistants to the Swell e-commerce platform. Its main tools list, retrieve, and search products; check inventory; list and inspect orders; update order status; and list, retrieve, and search customers using Swell store API credentials.

Install it by configuring your MCP client to run `npx swell-mcp` with `SWELL_STORE_ID` and `SWELL_SECRET_KEY`. Node.js 18 or newer is required. The README provides setup instructions for Claude Desktop, Cursor, VS Code, Windsurf, and LM Studio.

Yes, Swell MCP works with Cursor through Cursor Settings, then MCP, then Add new MCP Server. Use a command-based server with `npx swell-mcp` and provide the Swell credentials as environment variables.

Swell MCP requires `SWELL_STORE_ID` and `SWELL_SECRET_KEY`. `DEBUG` is optional for detailed logging and raw JSON responses. HTTP deployments can also set `TRANSPORT_MODE=http` and `PORT`.

Yes, the `swell_update_order_status` tool updates an order's status.

Related MCP servers

All in E-Commerce All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewSwell MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/swell-mcp?style=directory)](https://allmcps.com/mcp/swell-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/swell-mcp"><img src="https://allmcps.com/api/badge/swell-mcp?style=directory" alt="Swell MCP on AllMCPs" /></a>