ChannelEngine MCP by usefulapi

Read orders, products, stock and returns; acknowledge orders and set stock in ChannelEngine.

我该使用它吗

质量与安全性

A
描述质量
100%
模式完整度
81%
命名质量
73%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

发现(5)

  • LOWTool 'channelengine_list_stock_locations' name length outside 3-30 range在 channelengine_list_stock_locations 中
  • LOWTool 'channelengine_acknowledge_order' name length outside 3-30 range在 channelengine_acknowledge_order 中
  • LOWTool 'channelengine_list_channel_listings' name length outside 3-30 range在 channelengine_list_channel_listings 中
  • LOWTool 'channelengine_list_cancellations' name length outside 3-30 range在 channelengine_list_cancellations 中
  • LOWTool 'channelengine_list_notifications' name length outside 3-30 range在 channelengine_list_notifications 中

基于对工具定义和协议合规性的自动分析。

上下文开销

~2,902token 数(工具定义)
~1.6 KB典型响应大小
对注意力有显著影响(占 128k 上下文窗口的 2.27%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。

安装

一键安装

将以下内容添加到你的 `claude_desktop_config.json` 文件中:

{
  "mcpServers": {
    "channelengine": {
      "url": "https://channelengine.usefulapi.io/mcp"
    }
  }
}

远程端点

https://channelengine.usefulapi.io/mcpstreamable-http

它能做什么

工具清单

工具(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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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}.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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.

输入模式

{
  "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"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本15 个工具