ShopWired MCP by usefulapi
Read orders, products, customers and stock; set stock and order status in ShopWired.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
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": {
"shopwired": {
"url": "https://shopwired.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://shopwired.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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"
}Community
Nachweis