Catalog Machine MCP by usefulapi
Read products, orders and catalogs; update products and rebuild catalog PDFs in Catalog Machine.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
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": {
"catalog-machine": {
"url": "https://catalog-machine.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://catalog-machine.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢catalogmachine_list_products(category, collection, limit, page)
List products with all fields, variants and collections. Filter by category or collection. Catalog Machine API: GET /products.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"description": "Category name to filter by.",
"type": "string"
},
"collection": {
"description": "Collection number to filter by.",
"type": "string"
},
"limit": {
"description": "Records per page (1-250). Default 100.",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢catalogmachine_get_product(code)
Get one product by its Code, with all fields and variants. Catalog Machine API: GET /products/{code}.
Esquema de entrada
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"description": "The product Code (from catalogmachine_list_products)."
}
},
"required": [
"code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴catalogmachine_update_product(code, fields)
WRITE. Change fields of one product. The tool reads the product, merges your `fields` over it, and sends the full record back (the API needs the whole structure). Top-level keys only, for example Name, Price, Description. Variants and Collections replace the old list if you pass them. Catalog Machine API: GET then POST /products/{code}.
Esquema de entrada
{
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"description": "The product Code (from catalogmachine_list_products)."
},
"fields": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Fields to change, for example {\"Price\":\"15.99\",\"Description\":\"New text\"}. The Code cannot change."
}
},
"required": [
"code",
"fields"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢catalogmachine_list_categories
List product categories with their field definitions. Catalog Machine API: GET /categories.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢catalogmachine_list_orders(status, limit, page)
List orders (open orders by default), with customer and line items. Filter by status. Catalog Machine API: GET /orders.
Esquema de entrada
{
"type": "object",
"properties": {
"status": {
"description": "Order status to filter by.",
"type": "string"
},
"limit": {
"description": "Records per page (1-250). Default 100.",
"type": "integer",
"minimum": 1,
"maximum": 250
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢catalogmachine_list_catalogs(status)
List catalogs with permalink, status, privacy and the HTML and PDF links. Catalog Machine API: GET /catalogs.
Esquema de entrada
{
"type": "object",
"properties": {
"status": {
"description": "Filter by status.",
"type": "string",
"enum": [
"published",
"draft"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴catalogmachine_rebuild_catalog(permalink)
WRITE. Start a rebuild of the catalog PDF by permalink. Returns a JobId: check it with catalogmachine_get_catalog_job. Catalog Machine API: GET /catalogs/{permalink}/rebuild.
Esquema de entrada
{
"type": "object",
"properties": {
"permalink": {
"type": "string",
"minLength": 1,
"description": "Catalog permalink (from catalogmachine_list_catalogs)."
}
},
"required": [
"permalink"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢catalogmachine_get_catalog_job(job_id)
Get the status, errors and warnings of a catalog rebuild job. Catalog Machine API: GET /jobs/catalogs/{jobId}.
Esquema de entrada
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"minLength": 1,
"description": "The JobId from catalogmachine_rebuild_catalog (the catalog permalink)."
}
},
"required": [
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢catalogmachine_get_import_job(source)
Get the status of the last Shopify import job (`shopify`) or CSV import job (`csv`). Catalog Machine API: GET /jobs/import/shopify-import or /jobs/import/csv-import.
Esquema de entrada
{
"type": "object",
"properties": {
"source": {
"type": "string",
"enum": [
"shopify",
"csv"
],
"description": "Which import job to read."
}
},
"required": [
"source"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia