MCP MeasureMCP Measure

インデックス観測済み

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 件