Twice Commerce MCP by usefulapi

Read orders, customers, catalog, stock and availability; add order comments in Twice Commerce.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
89%
이름 품질
72%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (8)

  • LOWTool 'twicecommerce_list_service_locations' name length outside 3-30 rangetwicecommerce_list_service_locations에서
  • LOWTool 'twicecommerce_get_order_payments' name length outside 3-30 rangetwicecommerce_get_order_payments에서
  • LOWTool 'twicecommerce_get_order_invoices' name length outside 3-30 rangetwicecommerce_get_order_invoices에서
  • LOWTool 'twicecommerce_get_customer_orders' name length outside 3-30 rangetwicecommerce_get_customer_orders에서
  • LOWTool 'twicecommerce_list_catalog_items' name length outside 3-30 rangetwicecommerce_list_catalog_items에서
  • LOWTool 'twicecommerce_check_availability' name length outside 3-30 rangetwicecommerce_check_availability에서
  • LOWTool 'twicecommerce_list_discount_codes' name length outside 3-30 rangetwicecommerce_list_discount_codes에서
  • LOWTool 'twicecommerce_add_order_comment' name length outside 3-30 rangetwicecommerce_add_order_comment에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,741토큰 (도구 정의)
~866 B일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.14%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

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

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 20개