MCP App Store
by KeenEthics
Whatalo icon

Whatalo MCP Server for Claude and ChatGPT

By Whatalo

Overview

Connect Claude to your authorized Whatalo store to inspect and manage core commerce data through Whatalo's public API. View store information, products, categories, customers, orders, counts, inventory, and order line items. Filter and analyze catalog and order data with interactive widgets and structured results. The connector also supports creating and updating products and categories, managing product images, adjusting inventory, deactivating or deleting products, and updating order status. Tools are annotated so Claude can distinguish read-only, destructive, and idempotent operations. Access is scoped to the connected store through OAuth 2.1 permissions.

How to connect

  1. Claude: Open the Whatalo listing in the Claude connectors directory and choose Connect. Claude listing Whatalo exposes 25 tools here.
  2. ChatGPT: Open the Whatalo listing in the ChatGPT app directory and choose Connect. ChatGPT listing Whatalo exposes 25 tools here.

Tools

category_create

ChatGPT
Creates a new category. name is required; slug (auto-generated if omitted) and is_active are optional. WARNING: The Whatalo API does not support idempotency keys — a failed create followed by a retry may produce a duplicate category.

category_delete

ChatGPT
Permanently deletes a category. WARNING: This action is irreversible and cannot be undone. NOT idempotent — a second call on the same ID will return an error.

category_get

ChatGPT
Returns the full category record for the given category ID. All 5 category fields are included in the response. NOTE: A missing category ID may trigger an upstream 5xx error rather than 404.

category_list

ChatGPT
Returns a paginated list of categories with optional search filtering. per_page is clamped to a maximum of 100; omit or set to 0 to use the default of 25. IMPORTANT: This tool presents the primary data in a visual widget the user can see. Do not restate it in text. Use your response only for interpretation, caveats, or next steps.

category_update

ChatGPT
Partially updates a category. Only fields you provide are changed; omitted fields remain unchanged. Uses PATCH semantics.

customer_count

ChatGPT
Returns the total count of customers in the store. No filter parameters are accepted.

customer_get

ChatGPT
Returns the full customer record for the given customer ID. All 14 customer fields are included in the response. NOTE: A 404 response body may contain code VALIDATION_ERROR — this is a known API quirk; the tool maps by HTTP status. A missing customer ID may trigger an upstream 5xx error rather than 404.

order_count

ChatGPT
Returns the total count of orders. Accepts an optional status filter (pending|confirmed|in_progress|completed|cancelled|returned|all). Empty status returns all orders count.

order_get

ChatGPT
Returns the full order record for the given order ID. All 22 fields are included in the response, including nested customer, shipping_address, and items. Guest orders may omit customer and shipping_address. NOTE: A 404 response body code is uncertain for orders — the tool maps by HTTP status. A missing order ID may trigger an upstream 5xx error rather than 404. IMPORTANT: This tool presents the primary data in a visual widget the user can see. Do not restate it in text. Use your response only for interpretation, caveats, or next steps.

order_items_list

ChatGPT
Returns all line items for the given order ID. Each item includes a unique id and created_at, unlike the items returned by order_get.

order_list

ChatGPT
Returns a paginated list of orders with optional status filtering. per_page is clamped to a maximum of 100; omit or set to 0 to use the default of 25. Optional filters: status (array: pending|confirmed|processing|shipped|delivered|cancelled|refunded), payment_status, customer_id, date_from, date_to, total_min, total_max, updated_at_from, updated_at_to, city, province, country, country_code, sort (order_number|total|created_at|updated_at|customer_name), order (asc|desc). Date filters (date_from, date_to, updated_at_from, updated_at_to) must be RFC3339 date-time values; local timezone offsets are normalized to UTC ending in Z (for example 2026-06-04T00:00:00-04:00 becomes 2026-06-04T04:00:00.000Z), and date-only values are not accepted. Aggregation: set group_by=by_day with date_from+date_to+timezone (IANA) to get daily order totals instead of a list. timezone is only used for MCP-side group_by=by_day bucketing; it is not sent to the Whatalo Orders API. IMPORTANT: This tool presents the primary data in a visual widget the user can see. Do not restate it in text. Use your response only for interpretation, caveats, or next steps.

order_status_update

ChatGPT
Updates an order's status, payment_status, and/or internal_notes via PATCH. All three fields are optional — provide only what you want to change. Idempotent: setting the same value twice returns the same result. Returns the full updated order with extended fields including is_cancellable, is_fully_paid, and completed_at.

product_count

ChatGPT
Returns the total count of products. Default counts only active products — pass status=all to count all products regardless of lifecycle. Enum: active|draft|archived|all.

product_create

ChatGPT
Creates a new product. name and price are required; all other fields are optional. To add images (main image, gallery, or images inside the description), do NOT put base64 data or an external URL in main_image or description here — that will be rejected. Instead create the product first, then call product_image_upload with the returned product_id: it uploads the image to Whatalo and sets the gallery, main image (is_main), or description image. WARNING: The Whatalo API does not support idempotency keys — a failed create followed by a retry may produce a duplicate product.

product_deactivate

ChatGPT
Hides a product from the storefront by setting is_active=false. Idempotent: calling on an already-inactive product returns the current state without error.

product_delete

ChatGPT
Permanently deletes a product. WARNING: This action is irreversible and cannot be undone. NOT idempotent — a second call on the same ID will return an error.

product_get

ChatGPT
Returns the full product details for the given product ID, including variants when the API provides them. NOTE: A missing product ID may trigger an upstream 5xx error rather than 404. IMPORTANT: This tool presents the primary data in a visual widget the user can see. Do not restate it in text. Use your response only for interpretation, caveats, or next steps.

product_image_detach

ChatGPT
Removes an image from a product's gallery. Accepts either media_id or the image URL (a URL is resolved to its media_id via the media library). NOTE: this detaches ALL gallery instances of that media from the product; it does not delete the media from the library (there is no media-delete API). To remove an image embedded in the product description, edit the description text instead.

product_image_upload

ChatGPT
THIS is the tool to add or upload any image to a product — for the gallery, the main image, or images inside the description. Requires an existing product_id: to create a product with images, call product_create first, then call this with the new product_id. Provide each image as base64 image_data OR an image_url; the server performs the full upload and always hosts the file on Whatalo's CDN. Prefer image_url whenever the image is available at a URL: passing the URL is far faster than sending base64, and the server downloads and re-hosts it on Whatalo — use image_data only for raw bytes with no URL. Some MCP clients attach files directly instead of giving you base64 or a URL — when your input already includes a file reference with download_url/file_id, pass it via files instead of images, and set target/is_main/alt through file_options, since a file item can carry only the four fields the host fills. If you have neither a file reference, a URL, nor bytes for the image, ask the user for one instead of guessing. Upload the original file as-is: do not resize, compress, or re-encode it; only if a file exceeds the size limit (20 MB image, 50 MB video) compress it just enough to fit. Choosing target: product photos and catalog images usually belong in the gallery (max 15 per product); images that are part of rich, written description content usually belong embedded in the description. These are defaults to guide your judgment — explicit user instructions ALWAYS win. Images embed at full width by default: never invent width or height, omit them unless the user asks for a specific size. Each image succeeds or fails independently; every successful result returns its public_url and media_id so you can reference or remove it later without another call. Allowed types: jpeg, png, webp, avif, mp4, webm, quicktime.

product_inventory_adjust

ChatGPT
Adjusts product inventory by a delta amount (positive = add, negative = subtract). reason is required. WARNING: NOT idempotent — calling twice with the same delta applies the change twice. Adjustments already applied via this tool are permanent in the API.

product_inventory_get

ChatGPT
Returns the full inventory snapshot for the given product ID: product ID, SKU, tracking status, stock quantity, low-stock threshold, continue-selling status, and variant-level inventory when the API provides variants. NOTE: inventory uses continue_selling_when_out_of_stock (long name) distinct from product.continue_selling. IMPORTANT: This tool presents the primary data in a visual widget the user can see. Do not restate it in text. Use your response only for interpretation, caveats, or next steps.

product_list

ChatGPT
Returns a paginated list of products with optional filtering by status (active|draft|archived|all), category (array), featured status, price range (price_min, price_max), stock status, and search query. per_page is clamped to a maximum of 100; omit or set to 0 to use the default of 25. sort accepts: name|price|created_at|updated_at|stock_quantity. Aggregation: set group_by=by_price_range to get product counts distributed across 5 fixed price buckets instead of a list. IMPORTANT: This tool presents the primary data in a visual widget the user can see. Do not restate it in text. Use your response only for interpretation, caveats, or next steps.

product_update

ChatGPT
Partially updates a product. Only fields you provide are changed; omitted fields remain unchanged. Uses PATCH semantics. To add or change images, do NOT pass base64 data or an external URL in main_image or description — use product_image_upload with the product_id instead; it uploads to Whatalo and sets the gallery, main image, or description image. main_image only accepts a Whatalo CDN URL already produced by product_image_upload.

store_get

ChatGPT
Returns information about the merchant store associated with the credential forwarded by the MCP client. IMPORTANT: This tool presents the primary data in a visual widget the user can see. Do not restate it in text. Use your response only for interpretation, caveats, or next steps.

category_create

Claude

category_delete

Claude

category_get

Claude

category_list

Claude

category_update

Claude

customer_count

Claude

customer_get

Claude

order_count

Claude

order_get

Claude

order_items_list

Claude

order_list

Claude

order_status_update

Claude

product_count

Claude

product_create

Claude

product_deactivate

Claude

product_delete

Claude

product_get

Claude

product_image_detach

Claude

product_image_upload

Claude

product_inventory_adjust

Claude

product_inventory_get

Claude

product_list

Claude

product_update

Claude

store_get

Claude

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/whatalo"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/whatalo)