ShopWired MCP by usefulapi

Read orders, products, customers and stock; set stock and order status in ShopWired.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
95%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,758토큰 (도구 정의)
~1.7 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.15%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

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

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 14개