MCP MeasureMCP Measure

índice observado

Twice Commerce MCP by usefulapi

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

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
89%
Calidad de los nombres
72%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (8)

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

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~2,741Tokens (definiciones de herramientas)
~866 BTamaño de respuesta típico
Impacto significativo en la atención (2.14% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

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

Puntos de conexión remotos

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

Qué puede hacer

Inventario de herramientas

Herramientas (20)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Esquema de entrada

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

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada20 herramientas