Ecwid MCP by usefulapi is an MCP server published by io.usefulapi, hosted at ecwid.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 12 tools, including ecwid_get_store_profile, ecwid_search_products, ecwid_get_product, ecwid_search_orders, ecwid_get_order.
Read store products, orders, customers, categories and coupons; adjust inventory and update orders.
4,019 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the store's profile — general info (store id, name, currency), company details, and settings. Ecwid REST: GET /profile.
No parameters.
{
"name": "ecwid_get_store_profile",
"title": "Get store profile",
"description": "Get the store's profile — general info (store id, name, currency), company details, and settings. Ecwid REST: GET /profile.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get store profile",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Search / list the store's products with optional filters (keyword, SKU, category, stock, price range) and sorting. Returns a paged collection ({total, count, offset, limit, items}). Ecwid REST: GET /products.
| Parameter | Type | Description |
|---|---|---|
| sku | string | Filter by exact product SKU. |
| limit | integer | Max results per page (1-100). |
| offset | integer | Pagination offset. |
| sortBy | string | Sort order: RELEVANCE | PRICE_ASC | PRICE_DESC | NAME_ASC | NAME_DESC | ADDED_TIME_ASC | ADDED_TIME_DESC | UPDATED_TIME_ASC | UPDATED_TIME_DESC. |
| enabled | boolean | Filter to enabled (true) or disabled (false) products. |
| inStock | boolean | Filter to in-stock (true) or out-of-stock (false) products. |
| keyword | string | Full-text search term (matches title, description, SKU…). |
| priceTo | number | Maximum price (inclusive). |
| category | integer | Filter to products in this category id (0 = root). |
| priceFrom | number | Minimum price (inclusive). |
{
"name": "ecwid_search_products",
"title": "Search products",
"description": "Search / list the store's products with optional filters (keyword, SKU, category, stock, price range) and sorting. Returns a paged collection ({total, count, offset, limit, items}). Ecwid REST: GET /products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sku": {
"type": "string",
"description": "Filter by exact product SKU."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results per page (1-100)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset."
},
"sortBy": {
"enum": [
"RELEVANCE",
"PRICE_ASC",
"PRICE_DESC",
"NAME_ASC",
"NAME_DESC",
"ADDED_TIME_ASC",
"ADDED_TIME_DESC",
"UPDATED_TIME_ASC",
"UPDATED_TIME_DESC"
],
"type": "string",
"description": "Sort order: RELEVANCE | PRICE_ASC | PRICE_DESC | NAME_ASC | NAME_DESC | ADDED_TIME_ASC | ADDED_TIME_DESC | UPDATED_TIME_ASC | UPDATED_TIME_DESC."
},
"enabled": {
"type": "boolean",
"description": "Filter to enabled (true) or disabled (false) products."
},
"inStock": {
"type": "boolean",
"description": "Filter to in-stock (true) or out-of-stock (false) products."
},
"keyword": {
"type": "string",
"description": "Full-text search term (matches title, description, SKU…)."
},
"priceTo": {
"type": "number",
"description": "Maximum price (inclusive)."
},
"category": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter to products in this category id (0 = root)."
},
"priceFrom": {
"type": "number",
"description": "Minimum price (inclusive)."
}
}
},
"annotations": {
"title": "Search products",
"readOnlyHint": true
}
}Get a single product by its id, including price, stock, options, images, and category assignments. Ecwid REST: GET /products/{productId}.
| Parameter | Type | Description |
|---|---|---|
| product_id * | integer | Product id. |
{
"name": "ecwid_get_product",
"title": "Get product",
"description": "Get a single product by its id, including price, stock, options, images, and category assignments. Ecwid REST: GET /products/{productId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Product id."
}
}
},
"annotations": {
"title": "Get product",
"readOnlyHint": true
}
}Search / list the store's orders with optional filters (keyword, customer email/id, payment & fulfillment status, coupon, created-date range). Returns a paged collection. Ecwid REST: GET /orders.
| Parameter | Type | Description |
|---|---|---|
| string | Filter by customer email. | |
| limit | integer | Max results per page (1-100). |
| offset | integer | Pagination offset. |
| keyword | string | Full-text search term (order number, customer name, email…). |
| created_to | string | Filter to orders created on/before this date (YYYY-MM-DD or Unix timestamp). |
| coupon_code | string | Filter by applied coupon code. |
| customer_id | integer | Filter by customer id. |
| created_from | string | Filter to orders created on/after this date (YYYY-MM-DD or Unix timestamp). |
| payment_status | string | Filter by payment status: AWAITING_PAYMENT | PAID | CANCELLED | REFUNDED | PARTIALLY_REFUNDED | INCOMPLETE. |
| fulfillment_status | string | Filter by fulfillment status: AWAITING_PROCESSING | PROCESSING | SHIPPED | DELIVERED | WILL_NOT_DELIVER | RETURNED | READY_FOR_PICKUP | OUT_FOR_DELIVERY. |
{
"name": "ecwid_search_orders",
"title": "Search orders",
"description": "Search / list the store's orders with optional filters (keyword, customer email/id, payment & fulfillment status, coupon, created-date range). Returns a paged collection. Ecwid REST: GET /orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"description": "Filter by customer email."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results per page (1-100)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset."
},
"keyword": {
"type": "string",
"description": "Full-text search term (order number, customer name, email…)."
},
"created_to": {
"type": "string",
"description": "Filter to orders created on/before this date (YYYY-MM-DD or Unix timestamp)."
},
"coupon_code": {
"type": "string",
"description": "Filter by applied coupon code."
},
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by customer id."
},
"created_from": {
"type": "string",
"description": "Filter to orders created on/after this date (YYYY-MM-DD or Unix timestamp)."
},
"payment_status": {
"enum": [
"AWAITING_PAYMENT",
"PAID",
"CANCELLED",
"REFUNDED",
"PARTIALLY_REFUNDED",
"INCOMPLETE"
],
"type": "string",
"description": "Filter by payment status: AWAITING_PAYMENT | PAID | CANCELLED | REFUNDED | PARTIALLY_REFUNDED | INCOMPLETE."
},
"fulfillment_status": {
"enum": [
"AWAITING_PROCESSING",
"PROCESSING",
"SHIPPED",
"DELIVERED",
"WILL_NOT_DELIVER",
"RETURNED",
"READY_FOR_PICKUP",
"OUT_FOR_DELIVERY"
],
"type": "string",
"description": "Filter by fulfillment status: AWAITING_PROCESSING | PROCESSING | SHIPPED | DELIVERED | WILL_NOT_DELIVER | RETURNED | READY_FOR_PICKUP | OUT_FOR_DELIVERY."
}
}
},
"annotations": {
"title": "Search orders",
"readOnlyHint": true
}
}Get a single order by its order number, including line items, totals, customer, and payment/fulfillment status. Ecwid REST: GET /orders/{orderNumber}.
| Parameter | Type | Description |
|---|---|---|
| order_number * | any | Order number (the store-visible order id). |
{
"name": "ecwid_get_order",
"title": "Get order",
"description": "Get a single order by its order number, including line items, totals, customer, and payment/fulfillment status. Ecwid REST: GET /orders/{orderNumber}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_number"
],
"properties": {
"order_number": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
],
"description": "Order number (the store-visible order id)."
}
}
},
"annotations": {
"title": "Get order",
"readOnlyHint": true
}
}Search / list the store's customers with optional filters (keyword, email, name, customer group). Returns a paged collection. Ecwid REST: GET /customers.
| Parameter | Type | Description |
|---|---|---|
| name | string | Filter by customer name. |
| string | Filter by customer email. | |
| limit | integer | Max results per page (1-100). |
| offset | integer | Pagination offset. |
| keyword | string | Full-text search term (name, email…). |
| customer_group_id | integer | Filter by customer group id. |
{
"name": "ecwid_search_customers",
"title": "Search customers",
"description": "Search / list the store's customers with optional filters (keyword, email, name, customer group). Returns a paged collection. Ecwid REST: GET /customers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Filter by customer name."
},
"email": {
"type": "string",
"description": "Filter by customer email."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results per page (1-100)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset."
},
"keyword": {
"type": "string",
"description": "Full-text search term (name, email…)."
},
"customer_group_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Filter by customer group id."
}
}
},
"annotations": {
"title": "Search customers",
"readOnlyHint": true
}
}Get a single customer by id, including contact details, addresses, and customer group. Ecwid REST: GET /customers/{customerId}.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | integer | Customer id. |
{
"name": "ecwid_get_customer",
"title": "Get customer",
"description": "Get a single customer by id, including contact details, addresses, and customer group. Ecwid REST: GET /customers/{customerId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Customer id."
}
}
},
"annotations": {
"title": "Get customer",
"readOnlyHint": true
}
}List the store's product categories, optionally scoped to a parent category and including hidden ones. Returns a paged collection. Ecwid REST: GET /categories.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results per page (1-100). |
| offset | integer | Pagination offset. |
| parent | integer | List only subcategories of this parent category id (0 = root). |
| hidden_categories | boolean | Include hidden (disabled) categories when true. |
{
"name": "ecwid_list_categories",
"title": "List categories",
"description": "List the store's product categories, optionally scoped to a parent category and including hidden ones. Returns a paged collection. Ecwid REST: GET /categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results per page (1-100)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset."
},
"parent": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "List only subcategories of this parent category id (0 = root)."
},
"hidden_categories": {
"type": "boolean",
"description": "Include hidden (disabled) categories when true."
}
}
},
"annotations": {
"title": "List categories",
"readOnlyHint": true
}
}Get a single category by id, including its name, parent, product ids, and images. Ecwid REST: GET /categories/{categoryId}.
| Parameter | Type | Description |
|---|---|---|
| category_id * | integer | Category id. |
{
"name": "ecwid_get_category",
"title": "Get category",
"description": "Get a single category by id, including its name, parent, product ids, and images. Ecwid REST: GET /categories/{categoryId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category_id"
],
"properties": {
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Category id."
}
}
},
"annotations": {
"title": "Get category",
"readOnlyHint": true
}
}List the store's discount coupons with optional filters (coupon code, discount type, availability). Returns a paged collection. Ecwid REST: GET /discount_coupons.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results per page (1-100). |
| offset | integer | Pagination offset. |
| coupon_code | string | Filter by exact coupon code. |
| availability | string | Filter by availability, e.g. ACTIVE | PAUSED | EXPIRED | COMPLETE. |
| discount_type | string | Filter by discount type, e.g. ABS | PERCENT | SHIPPING | ABS_AND_SHIPPING | PERCENT_AND_SHIPPING. |
{
"name": "ecwid_list_discount_coupons",
"title": "List discount coupons",
"description": "List the store's discount coupons with optional filters (coupon code, discount type, availability). Returns a paged collection. Ecwid REST: GET /discount_coupons.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max results per page (1-100)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Pagination offset."
},
"coupon_code": {
"type": "string",
"description": "Filter by exact coupon code."
},
"availability": {
"type": "string",
"description": "Filter by availability, e.g. ACTIVE | PAUSED | EXPIRED | COMPLETE."
},
"discount_type": {
"type": "string",
"description": "Filter by discount type, e.g. ABS | PERCENT | SHIPPING | ABS_AND_SHIPPING | PERCENT_AND_SHIPPING."
}
}
},
"annotations": {
"title": "List discount coupons",
"readOnlyHint": true
}
}ADJUSTS a product's in-stock quantity by a delta — this MODIFIES live store data. Positive increases stock, negative decreases it. Ecwid REST: PUT /products/{productId}/inventory with JSON body {quantityDelta}. Returns {updateCount, warning?}.
| Parameter | Type | Description |
|---|---|---|
| product_id * | integer | Product id to adjust. |
| quantity_delta * | integer | Change in stock quantity — positive increases stock, negative decreases. |
{
"name": "ecwid_adjust_product_inventory",
"title": "Adjust product inventory",
"description": "ADJUSTS a product's in-stock quantity by a delta — this MODIFIES live store data. Positive increases stock, negative decreases it. Ecwid REST: PUT /products/{productId}/inventory with JSON body {quantityDelta}. Returns {updateCount, warning?}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id",
"quantity_delta"
],
"properties": {
"product_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Product id to adjust."
},
"quantity_delta": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Change in stock quantity — positive increases stock, negative decreases."
}
}
},
"annotations": {
"title": "Adjust product inventory",
"destructiveHint": true
}
}UPDATES an order — its payment status, fulfillment status, and/or tracking number. This MODIFIES live store data and may trigger customer notifications. Ecwid REST: PUT /orders/{orderNumber}. Provide only the fields you want to change. Returns {updateCount}.
| Parameter | Type | Description |
|---|---|---|
| order_number * | any | Order number to update. |
| payment_status | string | New payment status: AWAITING_PAYMENT | PAID | CANCELLED | REFUNDED | PARTIALLY_REFUNDED | INCOMPLETE. |
| tracking_number | string | Shipping tracking number to record on the order. |
| fulfillment_status | string | New fulfillment status: AWAITING_PROCESSING | PROCESSING | SHIPPED | DELIVERED | WILL_NOT_DELIVER | RETURNED | READY_FOR_PICKUP | OUT_FOR_DELIVERY. |
{
"name": "ecwid_update_order",
"title": "Update order",
"description": "UPDATES an order — its payment status, fulfillment status, and/or tracking number. This MODIFIES live store data and may trigger customer notifications. Ecwid REST: PUT /orders/{orderNumber}. Provide only the fields you want to change. Returns {updateCount}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_number"
],
"properties": {
"order_number": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "string"
}
],
"description": "Order number to update."
},
"payment_status": {
"enum": [
"AWAITING_PAYMENT",
"PAID",
"CANCELLED",
"REFUNDED",
"PARTIALLY_REFUNDED",
"INCOMPLETE"
],
"type": "string",
"description": "New payment status: AWAITING_PAYMENT | PAID | CANCELLED | REFUNDED | PARTIALLY_REFUNDED | INCOMPLETE."
},
"tracking_number": {
"type": "string",
"description": "Shipping tracking number to record on the order."
},
"fulfillment_status": {
"enum": [
"AWAITING_PROCESSING",
"PROCESSING",
"SHIPPED",
"DELIVERED",
"WILL_NOT_DELIVER",
"RETURNED",
"READY_FOR_PICKUP",
"OUT_FOR_DELIVERY"
],
"type": "string",
"description": "New fulfillment status: AWAITING_PROCESSING | PROCESSING | SHIPPED | DELIVERED | WILL_NOT_DELIVER | RETURNED | READY_FOR_PICKUP | OUT_FOR_DELIVERY."
}
}
},
"annotations": {
"title": "Update order",
"destructiveHint": true
}
}Tools for Ecwid, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which orders came in this week and what is the total?"; "Which products in my store are out of stock right now?"; "Search my store for a product called 'canvas tote bag'.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Ecwid data. Free plan: 50 tool calls per month. Run ecwid_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run ecwid_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run ecwid_upgrade without a plan: it returns both plans, each with a payment link for the user to open. ecwid_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.