MCP.Market

Swell MCP server

by devkindhq·io.github.devkindhq/swell·v1.1.0·2 stars

Model Context Protocol server for Swell e-commerce platform integration with AI assistants

C58/100grade C
What users say
No reviews yet
Be the first
Safety scan
C58/100

full report

Adoption
New

2 stars

Reviews

Write one

Nobody has reviewed Swell MCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Swell MCP tools (14, 6 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • swell_check_stock

    Check current stock levels and stock status for a specific product in your Swell store. Returns detailed stock information including levels, status, and availability messages. Optionally includes variant-level stock information.

  • swell_get_customer

    Get detailed information for a specific customer from your Swell store. Returns comprehensive customer profile including personal information, addresses, order history, and customer analytics. Use this tool when you need complete customer information.

  • swell_get_orderwrite action

    Get detailed information for a specific order from your Swell store. Returns comprehensive order details including items, customer information, billing and shipping addresses, payment details, and order history. Use this tool when you need complete order information.

  • swell_get_product

    Get detailed information for a specific product from your Swell store. Returns comprehensive product details including variants, categories, images, pricing, inventory, SEO information, and custom attributes. Use this tool when you need complete product information.

  • swell_list_customers

    List customers from your Swell store with search and filtering options. Supports filtering by email, date range, and various sorting options. Returns a formatted table of customers with basic information including name, email, order count, total value, and registration date.

  • swell_list_orders

    List orders from your Swell store with filtering options. Supports filtering by status, customer, date range, and various sorting options. Returns a formatted table of orders with basic information including order number, customer, status, total, and dates.

  • swell_list_products

    List products from your Swell store with filtering and pagination options. Supports filtering by active status, category, tags, and various sorting options. Returns a formatted table of products with basic information including ID, name, SKU, price, stock status, and availability.

  • swell_search_customers

    Search for customers in your Swell store using text queries. Searches across customer names, email addresses, and phone numbers. Returns ranked results with match information and supports filtering by date range and sorting options.

  • swell_search_products

    Search for products in your Swell store using text queries with optional filtering. Searches across product names, SKUs, descriptions, and tags. Returns ranked results with match information and supports the same filtering options as product listing.

  • swell_update_customerwrite action

    Update customer information in your Swell store. Allows modification of customer details including name, email, phone, notes, tags, and marketing preferences. Use this tool to correct customer information or update their profile.

  • swell_update_order_statuswrite action

    Update the status of an order in your Swell store. Allows changing order status to pending, payment_pending, delivery_pending, complete, or canceled. Optionally add notes about the status change. Returns the updated order information.

  • swell_update_productwrite action

    Update product information in your Swell store. Allows modification of product details including name, description, pricing, stock, SEO fields, categories, tags, and custom attributes. Returns a summary of changes made with before/after values.

  • swell_update_product_pricingwrite action

    Update pricing information for a product in your Swell store. Allows modification of regular price, sale price, and currency. Includes validation to ensure sale price is not higher than regular price.

  • swell_update_product_stockwrite action

    Update stock-specific information for a product in your Swell store. Allows modification of stock levels, stock status, and stock tracking settings. Use this tool for focused stock management operations.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

2 medium
  • Code scan73 source files scanned15/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 136 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Findings (2)

  • mediumnpm install lifecycle script presentinstall.script
  • mediumnpm install lifecycle script presentinstall.script
    package.json: …& node scripts/ensure-executable.js", "postinstall": "node scripts/ensure-executable.js", …
Overall 58/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Swell MCP compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
58/100
higher than 13% of 2,174 E-commerce servers
Tools
14
the typical E-commerce server has 6
Tools that change things
43%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 80% of 1,047 E-commerce servers

What its tools let an agent do: 8 read · 6 change

Install Swell MCP in Claude Code, Cursor or VS Code

Runs npx -y swell-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add swell -- npx -y swell-mcp
Add to Cursor

What the publisher says

From the Swell MCP repository's README, as published. We do not edit it. Read it on GitHub

Swell MCP Server

A Model Context Protocol server that integrates AI assistants with Swell's e-commerce platform. Built on a production-ready TypeScript foundation, it provides comprehensive access to Swell stores for product management, order processing, and customer management through both CLI and MCP tool interfaces.

Built by Devkind - Official Swell Partners serving businesses globally with cutting-edge e-commerce solutions.

Features

  • Swell E-commerce Integration: Complete access to Swell's API for products, orders, and customers
  • Dual Transport Support: STDIO and HTTP transports for AI assistant and web integration
  • 5-Layer Architecture: Clean separation between CLI, tools, controllers, services, and utilities
  • Type Safety: Full TypeScript implementation with Zod schema validation
  • Advanced HTTP Client: Built on swell-node SDK with connection pooling and retry logic
  • Comprehensive Testing: Unit and integration tests with Swell API mocking
  • Production Tooling: ESLint, Prettier, semantic-release, and MCP Inspector integration
  • Error Handling: Structured error handling with Swell-specific error contexts

Swell E-commerce Integration

This MCP server provides comprehensive integration with Swell's e-commerce platform:

Available Tools & Commands

MCP Tools:

  • swelllistproducts - List products with filtering and pagination
  • swellgetproduct - Get detailed product information
  • swellsearchproducts - Search products with multiple criteria
  • swellcheckinventory - Check product inventory levels
  • swelllistorders - List orders with filtering options
  • swellgetorder - Get detailed order information
  • swellupdateorder_status - Update order status
  • swelllistcustomers - List customers with search capabilities
  • swellgetcustomer - Get detailed customer information
  • swellsearchcustomers - Search customers with multiple criteria

Features Demonstrated

  • Product Management: Complete product catalog access with inventory tracking
  • Order Processing: Order lifecycle management with status updates
  • Customer Management: Customer profiles with order history and analytics
  • Error Handling: Structured errors for API failures and validation issues
  • Response Formatting: Clean Markdown output with structured data tables

Configuration Requirements

# Required - Swell API credentials
SWELL_STORE_ID=your-store-id
SWELL_SECRET_KEY=your-secret-key

# Development
DEBUG=true                    # Enable detailed logging
TRANSPORT_MODE=http          # Use HTTP transport
PORT=3001                    # Custom port

Need Advanced Swell Checkout?

This MCP server demonstrates the kind of sophisticated Swell integrations that power CheckoutJet - an enterprise-grade checkout solution for Swell stores built by Devkind.

CheckoutJet transforms your Swell checkout with:

  • 🏢 B2B Excellence - Professional invoicing, Net 30 payments, and wholesale pricing
  • 📦 Smart Shipping - Live rates from multiple locations with intelligent order routing
  • ⚡ Split Deliveries - Handle complex multi-vendor and multi-warehouse fulfillment
  • 🎨 Full Customization - Pixel-perfect, on-brand checkout experience
  • 🤖 Automation - Automated invoicing, POs, and order management
  • 💰 Advanced Pricing - Dynamic discounts and tiered pricing logic

Proven Results: Over €500,000 processed for Swell merchants with 23% conversion rate improvements.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Swell MCP: common questions

Is Swell MCP server safe?
With care: it is graded C, so read the findings first (58/100). Read the Swell MCP safety report
How do I install Swell MCP?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Swell MCP need an API key?
Yes. The registry entry asks for SWELL_SECRET_KEY.
Is Swell MCP maintained?
The last commit was 173 days ago (2026-05-15). The latest release is v1.1.0.
What can I use instead of Swell MCP?
Servers from other publishers that do the same job: Vtex MCP server, Cmssy MCP server and HasData MCP server.
How does Swell MCP compare with other E-commerce MCP servers?
safety score 58/100 (higher than 13% of 2,174 E-commerce servers); tools 14 (the typical E-commerce server has 6); tools that change things 43% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Swell MCP

Same job from other publishers: the closest match first, then the best rated.

  • Vtex
    MCP server for VTEX — e-commerce, orders, products, inventory, shipping
    B
  • Cmssy
    Hosted headless CMS with native commerce: pages, media, forms, products, orders, refunds, discounts.
    B
  • HasData
    All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.
    A
  • Kapruka MCP
    Free public MCP server for Kapruka.com — Sri Lanka's largest e-commerce platform.
    B
  • Google E-commerce (GA4, Search Console, Merchant Center, Ads)
    Multi-client read and controlled write (off by default): GA4, GSC, Merchant, GTM, ad platforms.
    B