Loading ToolBench
Model Context Protocol server for Swell e-commerce platform integration with AI assistants
Swell MCP demonstrates solid tool definition quality with consistent naming patterns, comprehensive parameter descriptions, and well-structured Zod schemas. All 14 tools follow verb_noun naming conventions (list_, get_, search_, update_, check_). Parameter descriptions are detailed and include constraints (enums, ranges, defaults). However, there are gaps in output schema documentation, while input schemas are explicit via Zod validation, tool response structures are not formally documented in the code, making it unclear to LLMs what fields to expect from API responses. Error handling is basic (no explicit recovery guidance in tool definitions). Tool composition is strong, tools chain logically (search → get → update) and return IDs needed for downstream calls. No security concerns detected in tool parameters (no exposed secrets). A few tools operate at the boundary of single responsibility, swell_update_product combines name, description, pricing, and stock in one call, whereas dedicated update_pricing and update_stock tools exist separately, creating potential ambiguity.
Check stock levels for a product in your Swell store. Returns current inventory status and optionally includes variant-level stock information. Use this tool to verify product availability before operations.
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.
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.
Get detailed information for a specific product from your Swell store. Returns comprehensive product details including variants, categories, images, pricing, inventory, and metadata. Use this tool when you need complete product information.
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.
Output schemas not formally documented in tool definitions. Response structures inferred from Swell API but not declared to LLMs, limiting their ability to plan downstream tool calls or validate returned fields.
swell_update_product combines multiple distinct concerns (name, description, pricing, SKU, stock, metadata, tags, categories) into a single tool. This overlaps with dedicated swell_update_product_stock and swell_update_product_pricing tools, creating ambiguity about when to use which update tool.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 65 | <=2025-11-25 | v2 |
| 2026-03-09 | D | 51 | 1.17.5+ | v1 |
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.
List products from your Swell store with filtering and pagination options. Supports filtering by active status, category, and tags with various sorting options. Returns a formatted table of products with basic information including name, price, SKU, and status.
Search for customers in your Swell store using a search query. Searches across customer name, email, and phone fields. Returns a formatted table of matching customers with pagination and sorting options.
Search for products in your Swell store using a search query. Searches across product name, description, and other fields. Returns a formatted table of matching products with pagination, filtering, and sorting options.
Update customer information in your Swell store. Allows modifying customer name, email, phone, notes, tags, group assignment, and marketing opt-in preferences. Returns the updated customer information.
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.
Update product information in your Swell store. Allows modifying product details including name, description, pricing, SKU, active status, stock levels, SEO metadata, tags, and custom attributes. Returns the updated product information.
Update pricing for a product in your Swell store. Allows modifying regular and sale prices with optional currency specification. Returns the updated product pricing information.
Update stock levels for a product in your Swell store through quantity adjustments. Allows incrementing or decrementing stock with optional reason tracking and order association. Returns the updated product inventory information.
Error handling guidance absent from tool definitions. Descriptions state what tools do but do not explain recovery paths for common failures (e.g., 'If customer not found, call swell_search_customers()' or 'Invalid sort parameter, must match pattern').
Pagination parameters (page, limit) present in list and search tools but no explicit documentation of response structure (total_count, has_next_page, etc.) or guidance on handling empty results.