Twice Commerce MCP by usefulapi
Read orders, customers, catalog, stock and availability; add order comments in Twice Commerce.
我該用這個嗎
品質與安全性
發現項目（8）
- LOWTool 'twicecommerce_list_service_locations' name length outside 3-30 range在 twicecommerce_list_service_locations 中
- LOWTool 'twicecommerce_get_order_payments' name length outside 3-30 range在 twicecommerce_get_order_payments 中
- LOWTool 'twicecommerce_get_order_invoices' name length outside 3-30 range在 twicecommerce_get_order_invoices 中
- LOWTool 'twicecommerce_get_customer_orders' name length outside 3-30 range在 twicecommerce_get_customer_orders 中
- LOWTool 'twicecommerce_list_catalog_items' name length outside 3-30 range在 twicecommerce_list_catalog_items 中
- LOWTool 'twicecommerce_check_availability' name length outside 3-30 range在 twicecommerce_check_availability 中
- LOWTool 'twicecommerce_list_discount_codes' name length outside 3-30 range在 twicecommerce_list_discount_codes 中
- LOWTool 'twicecommerce_add_order_comment' name length outside 3-30 range在 twicecommerce_add_order_comment 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"twice-commerce": {
"url": "https://twice-commerce.usefulapi.io/mcp"
}
}
}遠端端點
https://twice-commerce.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具（20）
🟢twicecommerce_get_merchant
Get the merchant account: name, country, currency, timezone, languages, plan and enabled features. Good first call. Admin API: GET /v1/admin/merchant.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_service_locations(scope)
List pickup and return locations (service locations). Use the ids to filter orders and stock items. Admin API: GET /v1/admin/service-locations/.
輸入結構描述
{
"type": "object",
"properties": {
"scope": {
"description": "Which locations to list (default active).",
"type": "string",
"enum": [
"active",
"archived",
"all"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_taxes
List the tax rates set up for the merchant. Admin API: GET /v1/admin/taxes/.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_tags(scope)
List tags used on inventory, catalog, customers or orders. Admin API: GET /v1/admin/tags.
輸入結構描述
{
"type": "object",
"properties": {
"scope": {
"type": "string",
"enum": [
"inventory",
"catalog",
"customers",
"orders"
],
"description": "Which area's tags to list."
}
},
"required": [
"scope"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_orders(location_ids, limit)
List orders with status, customers, line items, totals and dates. The API does not paginate this list, so the result is cut to `limit` rows (newest as returned by the API); the full count is in totalCount. Narrow it with location_ids. Admin API: GET /v1/admin/orders.
輸入結構描述
{
"type": "object",
"properties": {
"location_ids": {
"description": "Only orders at these service location ids.",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"description": "Maximum rows to return (default 50, max 200).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_order(order_id)
Get one order by id: status, customers, line items, stock items, comments, totals and pricing. Admin API: GET /v1/admin/orders/{orderId}.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"description": "The order id (uuid, from twicecommerce_list_orders)."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_order_payments(order_id)
List the payment transactions of one order (needs a key with the Payments area). Admin API: GET /v1/admin/orders/{orderId}/payments.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"description": "The order id (uuid)."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_order_invoices(order_id, include_scheduled)
List the invoices of one order, optionally with the upcoming scheduled subscription invoices (needs a key with the Payments area). Admin API: GET /v1/admin/orders/{orderId}/invoices.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"description": "The order id (uuid)."
},
"include_scheduled": {
"description": "Also list scheduled (upcoming) subscription invoices.",
"type": "boolean"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_customers(search, sort_by, sort_direction, page, size)
List customers, with an optional text search over name and email and paging. Admin API: GET /v1/admin/customers.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Text to search for (contains match).",
"type": "string"
},
"sort_by": {
"type": "string",
"enum": [
"createdAt",
"firstName",
"lastName",
"fullName",
"email",
"companyName"
]
},
"sort_direction": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Rows per page (default 25, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_customer(customer_id)
Get one customer by id: contact details, addresses and type. Admin API: GET /v1/admin/customers/{customerId}.
輸入結構描述
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"description": "The customer id (uuid, from twicecommerce_list_customers)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_customer_orders(customer_id)
List the orders of one customer. Admin API: GET /v1/admin/customers/{customerId}/orders.
輸入結構描述
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"description": "The customer id (uuid)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_catalog_items(name, sort_by, sort_direction, page, size)
List catalog items (the listings customers rent, buy or subscribe to), with an optional name search and paging. Admin API: GET /v1/admin/catalog/.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"description": "Only listings whose name contains this text.",
"type": "string"
},
"sort_by": {
"type": "string",
"enum": [
"createdAt",
"name",
"internalName",
"status"
]
},
"sort_direction": {
"description": "Sort direction.",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Rows per page (default 25, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_catalog_item(catalog_item_id)
Get one catalog item by id: name, status, variants, rules and pricing links. Admin API: GET /v1/admin/catalog/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"catalog_item_id": {
"type": "string",
"description": "The catalog item id (from twicecommerce_list_catalog_items)."
}
},
"required": [
"catalog_item_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_check_availability(catalog_item_id, from, to, location_ids)
Check whether one catalog item can be booked for a date-time window (before you create an order). Dates are ISO 8601 date-times in UTC, for example 2026-11-05T09:00:00Z. Admin API: GET /v1/admin/availability/{catalogItemId}/period.
輸入結構描述
{
"type": "object",
"properties": {
"catalog_item_id": {
"type": "string",
"description": "The catalog item id."
},
"from": {
"type": "string",
"description": "Start date-time, ISO 8601 UTC (example 2026-11-05T09:00:00Z)."
},
"to": {
"type": "string",
"description": "End date-time, ISO 8601 UTC."
},
"location_ids": {
"description": "Only check these service location ids.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"catalog_item_id",
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_discount_codes(search, page, size)
List discount codes with usage and validity, with paging. Admin API: GET /v1/admin/discount-codes.
輸入結構描述
{
"type": "object",
"properties": {
"search": {
"description": "Text to search for.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Rows per page (default 25, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_stock_items(location_ids, page, size)
List stock items (the physical units, called articles in the API), with paging. Narrow by location ids. Admin API: GET /v1/admin/articles/.
輸入結構描述
{
"type": "object",
"properties": {
"location_ids": {
"description": "Only stock items at these service location ids.",
"type": "array",
"items": {
"type": "string"
}
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Rows per page (default 25, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_stock_item(stock_item_id)
Get one stock item by id: SKU, condition, quantity, location and status. Admin API: GET /v1/admin/articles/{id}.
輸入結構描述
{
"type": "object",
"properties": {
"stock_item_id": {
"type": "string",
"description": "The stock item id (from twicecommerce_list_stock_items)."
}
},
"required": [
"stock_item_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_list_skus(page, size)
List SKUs (the product definitions that stock items belong to), with paging. Admin API: GET /v1/admin/skus.
輸入結構描述
{
"type": "object",
"properties": {
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"size": {
"description": "Rows per page (default 25, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢twicecommerce_get_sku(sku_id)
Get one SKU by id. Admin API: GET /v1/admin/skus/{skuId}.
輸入結構描述
{
"type": "object",
"properties": {
"sku_id": {
"type": "string",
"description": "The SKU id (uuid, from twicecommerce_list_skus)."
}
},
"required": [
"sku_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴twicecommerce_add_order_comment(order_id, content)
WRITE: add a comment to an order (needs a key with Write access to Order details). Each call adds a new comment; do not repeat a call that succeeded. Admin API: POST /v1/admin/orders/{orderId}/comments.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"description": "The order id (uuid)."
},
"content": {
"type": "string",
"minLength": 1,
"maxLength": 5000,
"description": "The comment text."
}
},
"required": [
"order_id",
"content"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據