Twice Commerce MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
89%
Qualität der Benennung
72%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (8)

  • LOWTool 'twicecommerce_list_service_locations' name length outside 3-30 rangein twicecommerce_list_service_locations
  • LOWTool 'twicecommerce_get_order_payments' name length outside 3-30 rangein twicecommerce_get_order_payments
  • LOWTool 'twicecommerce_get_order_invoices' name length outside 3-30 rangein twicecommerce_get_order_invoices
  • LOWTool 'twicecommerce_get_customer_orders' name length outside 3-30 rangein twicecommerce_get_customer_orders
  • LOWTool 'twicecommerce_list_catalog_items' name length outside 3-30 rangein twicecommerce_list_catalog_items
  • LOWTool 'twicecommerce_check_availability' name length outside 3-30 rangein twicecommerce_check_availability
  • LOWTool 'twicecommerce_list_discount_codes' name length outside 3-30 rangein twicecommerce_list_discount_codes
  • LOWTool 'twicecommerce_add_order_comment' name length outside 3-30 rangein twicecommerce_add_order_comment

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~2,741Tokens (Tool-Definitionen)
~866 BTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.14% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "twice-commerce": {
      "url": "https://twice-commerce.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://twice-commerce.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (20)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Eingabe-Schema

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

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet20 Tools