ShopWired MCP by usefulapi
Read orders, products, customers and stock; set stock and order status in ShopWired.
¿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": {
"shopwired": {
"url": "https://shopwired.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://shopwired.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (14)
🟢shopwired_get_business(fields, embed)
Get the ShopWired business account: name, domain, default currency and package. Good first call to confirm which store the key belongs to. ShopWired API: GET /business.
Esquema de entrada
{
"type": "object",
"properties": {
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_list_orders(ids, archived, status, from, to, ...)
List orders, newest first by default. Filter by status id, archived flag or created date range (from/to). Each order has its id, reference, created date, status and tracking URL. ShopWired API: GET /orders.
Esquema de entrada
{
"type": "object",
"properties": {
"ids": {
"description": "Comma-separated order ids to return.",
"type": "string"
},
"archived": {
"description": "true = only archived orders, false = only active orders.",
"type": "boolean"
},
"status": {
"description": "Only orders with this status id.",
"type": "string"
},
"from": {
"description": "Only orders created on or after this date.",
"type": "string"
},
"to": {
"description": "Only orders created on or before this date.",
"type": "string"
},
"count": {
"description": "Records to return (default 50, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Records to skip, for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sort": {
"description": "Sort field, as the ShopWired API accepts it.",
"type": "string"
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_get_order(order_id, fields, embed)
Get one order by id, with its status, customer, line items and totals. ShopWired API: GET /orders/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"description": "The numeric ShopWired id."
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_search_orders(keywords, sort, offset, count)
Search orders by keyword (order reference, customer name or email, and similar). Returns totalItems and the matching orders. ShopWired API: GET /orders/search.
Esquema de entrada
{
"type": "object",
"properties": {
"keywords": {
"type": "string",
"minLength": 1,
"description": "Text to search for."
},
"sort": {
"description": "Sort field, as the ShopWired API accepts it.",
"type": "string"
},
"offset": {
"description": "Records to skip, for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"count": {
"description": "Records to return (default 50, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"required": [
"keywords"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_list_products(active, count, offset, sort, fields, ...)
List products in the store, with name, price, stock and active state. Filter by active flag. ShopWired API: GET /products.
Esquema de entrada
{
"type": "object",
"properties": {
"active": {
"description": "true = only active products, false = only inactive products.",
"type": "boolean"
},
"count": {
"description": "Records to return (default 50, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Records to skip, for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sort": {
"description": "Sort field, as the ShopWired API accepts it.",
"type": "string"
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_get_product(product_id, fields, embed)
Get one product by id, with its description, price, variations and stock details. ShopWired API: GET /products/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "The numeric ShopWired id."
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"required": [
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_search_products(keywords, sort, offset, count, fields, ...)
Search products by keyword (name, SKU and similar). ShopWired API: GET /products/search.
Esquema de entrada
{
"type": "object",
"properties": {
"keywords": {
"type": "string",
"minLength": 1,
"description": "Text to search for."
},
"sort": {
"description": "Sort field, as the ShopWired API accepts it.",
"type": "string"
},
"offset": {
"description": "Records to skip, for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"count": {
"description": "Records to return (default 50, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"required": [
"keywords"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_list_customers(email, trade, count, offset, sort, ...)
List customer accounts, with name, email and trade flag. Filter by email or trade status. ShopWired API: GET /customers.
Esquema de entrada
{
"type": "object",
"properties": {
"email": {
"description": "Only the customer with this email address.",
"type": "string"
},
"trade": {
"description": "true = only trade customers, false = only retail customers.",
"type": "boolean"
},
"count": {
"description": "Records to return (default 50, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Records to skip, for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sort": {
"description": "Sort field, as the ShopWired API accepts it.",
"type": "string"
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_get_customer(customer_id, fields, embed)
Get one customer account by id, with contact details, addresses and trade status. ShopWired API: GET /customers/{id}.
Esquema de entrada
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "The numeric ShopWired id."
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_get_stock(sku)
Get the stock quantity for one SKU (a product or a product variation). ShopWired API: GET /stock.
Esquema de entrada
{
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"description": "The SKU code of the product or variation."
}
},
"required": [
"sku"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_list_categories(count, offset, sort, fields, embed)
List product categories. Use embed=parents to include each category's parents. ShopWired API: GET /categories.
Esquema de entrada
{
"type": "object",
"properties": {
"count": {
"description": "Records to return (default 50, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Records to skip, for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sort": {
"description": "Sort field, as the ShopWired API accepts it.",
"type": "string"
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
},
"embed": {
"description": "Comma-separated related objects to include (for example 'parents' on categories).",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢shopwired_list_brands(count, offset, sort, fields)
List the active product brands in the store. ShopWired API: GET /brands.
Esquema de entrada
{
"type": "object",
"properties": {
"count": {
"description": "Records to return (default 50, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Records to skip, for pagination.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"sort": {
"description": "Sort field, as the ShopWired API accepts it.",
"type": "string"
},
"fields": {
"description": "Comma-separated field names to return, to shorten the response.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡shopwired_update_stock(sku, quantity, items)
SETS the stock quantity for one SKU, or for up to 15 SKUs in one call (items). It replaces the current value; it does not add to it. Check the current value with shopwired_get_stock first. ShopWired API: POST /stock.
Esquema de entrada
{
"type": "object",
"properties": {
"sku": {
"description": "SKU to set (single update; use with quantity).",
"type": "string",
"minLength": 1
},
"quantity": {
"description": "New stock quantity for sku.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"items": {
"description": "Up to 15 SKUs with their new quantities (use instead of sku and quantity).",
"minItems": 1,
"maxItems": 15,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"sku",
"quantity"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴shopwired_update_order_status(order_id, status, trackingUrl, sendEmail)
CHANGES an order's status, and optionally its tracking URL. When sendEmail is true the customer receives a status email, so only set it on purpose. Status ids come from the store's order statuses. ShopWired API: POST /orders/{id}/status.
Esquema de entrada
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"description": "The numeric ShopWired id."
},
"status": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The new status id."
},
"trackingUrl": {
"description": "New tracking URL for the order.",
"type": "string",
"format": "uri"
},
"sendEmail": {
"description": "true = email the customer about the status change (default false).",
"type": "boolean"
}
},
"required": [
"order_id",
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia