MCP App Store
by KeenEthics
EcomWeb icon

EcomWeb MCP Server for Claude and ChatGPT

By EcomWeb

Overview

EcomWeb is an e-commerce platform for Vietnamese merchants. This connector lets a store owner or staff member run their store from Claude. What you can do: - Products: search and view products, create one or up to 10 at a time (with options, variants, prices in VND, stock and images from public URLs), update them, change status in bulk, and delete them. - Promotions: list, create, update, pause and delete discount codes and automatic discounts, and see promotion statistics. - Orders: list and view orders with items, payment and shipping status (read-only). - Reports: sales summary for a day, week, month or year with growth, and best-selling products. - Stores: list the stores you belong to and switch between them by name. How it works: you sign in with your EcomWeb account and approve the connection on ecomweb.app (OAuth 2.1 with PKCE). Claude then acts with your own store role and permissions, so staff can only do what they can already do in the dashboard. Deleting products or promotions always asks for confirmation. You can see and revoke connected apps any time under Profile > Sessions in the EcomWeb dashboard. Requires an EcomWeb plan that includes the AI connector.

How to connect

  1. Claude: Open the EcomWeb listing in the Claude connectors directory and choose Connect. Claude listing EcomWeb exposes 20 tools here.
  2. ChatGPT: Open the EcomWeb listing in the ChatGPT app directory and choose Connect. ChatGPT listing EcomWeb exposes 22 tools here.

Tools

batch_create_products

ChatGPT
Create up to 10 products in one call, each with the same fields as create_product. Options are looked up and created once for the whole batch, before any product; if that fails, nothing is created. Each product then succeeds or fails on its own (an image that can't be used fails only its product), reported by index in results. An item whose error is TIME_BUDGET_EXCEEDED ran out of time and was not done: retry it in a new call. If that error has details.applied, those changes were already made: retry only the rest.

batch_update_products

ChatGPT
Apply the same changes to up to 10 products, such as a status, tags, or the price of products with one variant each. It cannot change images or single variants: use update_product for those, one product at a time. An active product cannot go straight to draft: set it to unlisted first, then draft. Each product succeeds or fails on its own (a product with several variants given a price fails with VARIANT_REQUIRED), reported by index in results. An item whose error is TIME_BUDGET_EXCEEDED ran out of time and was not done: retry it in a new call. If that error has details.applied, those changes were already made: retry only the rest.

create_product

ChatGPT
Create one product, as a draft unless status says otherwise. Prices are in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). A product without options takes price (and optionally inventory and sku). A product with options (such as Size or Màu) takes options with their values and one variant per combination to sell, each naming a value for every option, e.g. {"Size": "M"}. Existing store options are reused. images are public image URLs, downloaded into the store, or asset_ids; if one can't be used, the product is not created. collection_ids adds it to collections from list_categories; a collection that fails is reported in warnings. For several products use batch_create_products.

create_promotion

ChatGPT
Create a promotion. It is active from start_at (default now). Money is in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). A DISCOUNT_CODE promotion needs code; a condition_type of PRODUCT or VARIANT needs target_ids.

delete_products

ChatGPT
Permanently deletes products. This cannot be undone. Takes 1 to 10 product ids. Each is deleted on its own and reported by index in results, so some can fail (for example a product with open orders) while others are deleted. An item whose error is TIME_BUDGET_EXCEEDED ran out of time and was not done: retry it in a new call. If that error has details.applied, those changes were already made: retry only the rest.

delete_promotion

ChatGPT
Delete one promotion. This cannot be undone from here; to stop a promotion temporarily use update_promotion with status DISABLED.

get_bug_reports

ChatGPT
Shows the status of the merchant's bug reports and the staff reply: one report by its number, or up to 20 of the reports they can see, newest first, optionally for one store or status.

get_order

ChatGPT
Get one order with its items, totals, payment, fulfillment and shipping status. Give exactly one of order_id (from list_orders) or order_number (the number customers quote, such as 1042). Read-only: refunding, cancelling, fulfilling or editing an order isn't possible here; that is done in the ecomweb dashboard.

get_product

ChatGPT
Get one product with its description, tags, images (asset ids and URLs) and every variant with its options, SKU, price (in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99)) and stock.

get_promotion

ChatGPT
Get one promotion by promotion_id or by its code. Give exactly one of them.

get_store

ChatGPT
Get a store's name, description, status, handle, custom domain, currency and logo.

list_categories

ChatGPT
List the store's collections and, with taxonomy_query, search the global category taxonomy. Products have one taxonomy category_code and can be in many collections. Collections are paged 100 at a time: use collections_next_offset when it is not null.

list_orders

ChatGPT
List the store's orders, newest first, with status, customer and total. Read-only: refunding, cancelling, fulfilling or editing an order isn't possible here; that is done in the ecomweb dashboard. created_after and created_before take dates, which are whole days in the store's timezone, inclusive, or ISO times with offset. Results are paged: when next_offset is not null, call again with that offset for more. Use get_order for the items of one order.

list_promotions

ChatGPT
List the store's promotions (discount codes and automatic discounts), newest first. Results are paged: when next_offset is not null, call again with that offset for more.

list_stores

ChatGPT
List the merchant's stores with their ref, name, handle, status, currency, the merchant's role, plan and whether the plan includes the AI connector.

promotion_stats

ChatGPT
Store-wide promotion numbers: how many promotions are active, draft, expired or disabled, how many times promotions were used and the total discount given, and the five most used promotions. Uses count orders that are not cancelled. Owners and admins only.

report_bug

ChatGPT
Files a bug report with ecomweb staff when the merchant asks to report a problem with ecomweb or this connector. Sends only the fields given here: a title, a description, optional steps to reproduce, whether the problem stops the merchant selling or running their store, the store it is about, and the name and error code of a tool that failed. Nothing else from the conversation is sent. Returns a report number the merchant can quote to check on it.

sales_summary

ChatGPT
Revenue, orders, customers and average order value for a period, with growth. Growth compares with the equal-length period just before. Give period (day, week, month or year; default day) or both start_date and end_date. customer_activity_rate is the share of the store's customers who ordered in the period; it is not a website conversion rate. Owners and admins only.

search_products

ChatGPT
Search and filter the store's products, newest first unless sorted. Prices are in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). category_code is a taxonomy code from list_categories. Each item's inventory_total is its stock across variants; use it (not a status) to judge stock. collection_id is a manual collection's id from list_categories; a smart collection (products chosen by rules) can't be used and answers an error. Results are paged: when next_offset is not null, call again with that offset for more.

top_products

ChatGPT
Best-selling products in a date range, ranked by revenue or by units sold. Without dates it covers the last 30 days including today (Asia/Ho_Chi_Minh). truncated true means more products matched than were returned. Owners and admins only.

update_product

ChatGPT
Change one product: only the fields given change. Prices are in the store's currency: a whole number for VND (150000), up to 2 decimals for USD (29.99). images replaces the whole image list: keep an image by passing its asset_id from get_product (or its url when it has no asset_id, which copies it into the store); new URLs are downloaded, and if one can't be used nothing changes. price, inventory and sku change a product with exactly one variant. On a product with several variants they fail with VARIANT_REQUIRED, listing the variants; to change one variant, pass variants with its variant_id. Changes apply in order (fields, then variants) and stop at the first failure; that error's details.applied lists what had already changed. An active product cannot go straight to draft: set it to unlisted first, then draft. Returns the product as get_product does.

update_promotion

ChatGPT
Pause (status DISABLED) or resume (status ACTIVE) a promotion. A promotion's terms (discount, dates, products, code, limits) can't be changed once it is created; to change them, pause it and create a new promotion with create_promotion.

batch_create_products

Claude

batch_update_products

Claude

create_product

Claude

create_promotion

Claude

delete_products

Claude

delete_promotion

Claude

get_order

Claude

get_product

Claude

get_promotion

Claude

get_store

Claude

list_categories

Claude

list_orders

Claude

list_promotions

Claude

list_stores

Claude

promotion_stats

Claude

sales_summary

Claude

search_products

Claude

top_products

Claude

update_product

Claude

update_promotion

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/ecomweb"><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/ecomweb)