ChannelEngine MCP by usefulapi
Read orders, products, stock and returns; acknowledge orders and set stock in ChannelEngine.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (5)
- LOWen channelengine_list_stock_locations
- LOWen channelengine_acknowledge_order
- LOWen channelengine_list_channel_listings
- LOWen channelengine_list_cancellations
- LOWen channelengine_list_notifications
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"channelengine": {
"url": "https://channelengine.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://channelengine.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (15)
🟢channelengine_list_channels
List the marketplaces and webshops (channels) connected to this merchant account, with their ids. Good first call: channel ids are used by the other filters. Merchant API: GET /api/v2/channels.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_settings
Get the merchant account settings in ChannelEngine. Merchant API: GET /api/v2/settings.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_stock_locations
List the stock locations (warehouses) of this merchant account, with their ids. Merchant API: GET /api/v2/stocklocations.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_orders(statuses, merchant_order_nos, channel_order_nos, channel_ids, from_date, ...)
List orders with filters: status, order numbers, channel, order date range and acknowledgement state. Returns Content plus TotalCount. Merchant API: GET /api/v2/orders.
Esquema de entrada
{
"type": "object",
"properties": {
"statuses": {
"description": "Filter on one or more order statuses (for example NEW, IN_PROGRESS or SHIPPED). AWAITING_PAYMENT orders are excluded unless listed.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_ids": {
"description": "Filter on one or more channel ids (see channelengine_list_channels).",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"from_date": {
"description": "Order date from (inclusive).",
"type": "string"
},
"to_date": {
"description": "Order date until (exclusive).",
"type": "string"
},
"is_acknowledged": {
"description": "Only acknowledged (true) or unacknowledged (false) orders.",
"type": "boolean"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_new_orders(stock_location_id)
Get the orders that are new and not yet processed by the merchant (the usual order-intake call). Merchant API: GET /api/v2/orders/new.
Esquema de entrada
{
"type": "object",
"properties": {
"stock_location_id": {
"description": "Only orders for this stock location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡channelengine_acknowledge_order(order_id, merchant_order_no)
WRITE: acknowledge one order, which tells the channel the merchant accepted it. Needs the ChannelEngine OrderId (from channelengine_list_orders). Optionally sets your own MerchantOrderNo on it. Merchant API: POST /api/v2/orders/acknowledge.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The ChannelEngine order id (the Id field of the order)."
},
"merchant_order_no": {
"description": "Your own order reference to store on the order.",
"type": "string"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_products(search, eans, merchant_product_nos, page_size, page)
Search the merchant product catalogue by name, merchant product number, EAN or brand, or by explicit lists of product numbers or EANs. Merchant API: GET /api/v2/products.
Esquema de entrada
{
"type": "object",
"properties": {
"search": {
"description": "Search by name, merchant product number, EAN or brand.",
"type": "string"
},
"eans": {
"description": "Filter on one or more EAN codes.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_product_nos": {
"description": "Filter on one or more merchant product numbers (SKUs).",
"type": "array",
"items": {
"type": "string"
}
},
"page_size": {
"description": "Products per page (default: all).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_product(merchant_product_no)
Get one product by its merchant product number (SKU). Merchant API: GET /api/v2/products/{merchantProductNo}.
Esquema de entrada
{
"type": "object",
"properties": {
"merchant_product_no": {
"type": "string",
"minLength": 1,
"description": "The merchant product number (SKU)."
}
},
"required": [
"merchant_product_no"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_channel_listings(channel_id, merchant_product_nos, page)
List the products listed on one channel (marketplace or webshop), optionally for given merchant product numbers. Merchant API: GET /api/v2/channels/{channelId}/products.
Esquema de entrada
{
"type": "object",
"properties": {
"channel_id": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "The channel id (see channelengine_list_channels)."
},
"merchant_product_nos": {
"description": "Filter on one or more merchant product numbers (SKUs).",
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"channel_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_get_stock(skus, stock_location_ids, page_index, page_size)
Get the stock level per product across all stock locations. Pages start at index 0 here. Merchant API: GET /api/v2/offer/stock.
Esquema de entrada
{
"type": "object",
"properties": {
"skus": {
"description": "Filter on one or more product SKUs (merchant product numbers).",
"type": "array",
"items": {
"type": "string"
}
},
"stock_location_ids": {
"description": "Filter on one or more stock location ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"page_index": {
"description": "Page index, starting at 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"page_size": {
"description": "Items per page (default 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴channelengine_update_stock(updates)
WRITE: set the absolute stock for products at stock locations. This changes live stock on every connected channel. Send the full stock per location, not a change. Merchant API: PUT /api/v2/offer/stock.
Esquema de entrada
{
"type": "object",
"properties": {
"updates": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"merchant_product_no": {
"type": "string",
"minLength": 1,
"description": "The product SKU."
},
"stock_locations": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"stock_location_id": {
"description": "The stock location id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"stock": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "The new absolute stock quantity."
}
},
"required": [
"stock"
]
}
}
},
"required": [
"merchant_product_no",
"stock_locations"
]
},
"description": "Stock updates, one entry per product (max 100)."
}
},
"required": [
"updates"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_shipments(merchant_order_nos, merchant_shipment_nos, channel_order_nos, channel_id, from_create_date, ...)
List shipments created for merchant orders, with filters on order, shipment, create date and channel. Merchant API: GET /api/v2/shipments/merchant.
Esquema de entrada
{
"type": "object",
"properties": {
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_shipment_nos": {
"description": "Filter on one or more merchant shipment numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_id": {
"description": "Only shipments for this channel id.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"from_create_date": {
"description": "Created from (inclusive).",
"type": "string"
},
"to_create_date": {
"description": "Created until (exclusive).",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_returns(channel_ids, merchant_order_nos, channel_order_nos, statuses, from_date, ...)
List returns for merchant orders, with filters on channel, order, status, date and acknowledgement. Merchant API: GET /api/v2/returns/merchant.
Esquema de entrada
{
"type": "object",
"properties": {
"channel_ids": {
"description": "Filter on one or more channel ids.",
"type": "array",
"items": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
}
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"statuses": {
"description": "Filter on one or more return statuses.",
"type": "array",
"items": {
"type": "string"
}
},
"from_date": {
"description": "Created from (inclusive).",
"type": "string"
},
"to_date": {
"description": "Created until (exclusive).",
"type": "string"
},
"is_acknowledged": {
"description": "Only acknowledged (true) or unacknowledged (false) returns.",
"type": "boolean"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_cancellations(created_since, created_to, merchant_order_nos, channel_order_nos, page)
List order cancellations for this merchant, with filters on creation date and order numbers. Merchant API: GET /api/v2/cancellations/merchant.
Esquema de entrada
{
"type": "object",
"properties": {
"created_since": {
"description": "Created since this date-time.",
"type": "string"
},
"created_to": {
"description": "Created until this date-time.",
"type": "string"
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢channelengine_list_notifications(from_date, to_date, types, merchant_order_nos, channel_order_nos, ...)
List notifications ChannelEngine raised for this merchant (for example order or shipment problems), with date and order filters. Merchant API: GET /api/v2/notifications.
Esquema de entrada
{
"type": "object",
"properties": {
"from_date": {
"description": "From this date-time.",
"type": "string"
},
"to_date": {
"description": "Until this date-time.",
"type": "string"
},
"types": {
"description": "Filter on one or more notification types.",
"type": "array",
"items": {
"type": "string"
}
},
"merchant_order_nos": {
"description": "Filter on one or more merchant order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"channel_order_nos": {
"description": "Filter on one or more channel order numbers.",
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia