ShopWired MCP by usefulapi
Read orders, products, customers and stock; set stock and order status in ShopWired.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"shopwired": {
"url": "https://shopwired.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://shopwired.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거