Spreadconnect MCP by usefulapi
Read orders, shipments, stock and articles; create, confirm and cancel orders in Spreadconnect.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"spod": {
"url": "https://spod.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://spod.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(19)
🟢spod_get_account
The Spreadconnect integration this API key belongs to: merchant id, point-of-sale id, name and type. A cheap way to confirm the connection. GET /authentication.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_list_articles(limit, offset)
List the articles (your own designed products) of this point of sale: id, title, description and variants with sku, size, colour and prices. The sku is what spod_create_order needs. GET /articles.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_get_article(article_id)
One article with all details: variants (sku, size, colour, prices), images and configuration. GET /articles/{articleId}.
入力スキーマ
{
"type": "object",
"properties": {
"article_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect article id (from spod_list_articles)."
}
},
"required": [
"article_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_get_order(order_id)
One order by Spreadconnect order id: state (NEW, CONFIRMED, PROCESSED, CANCELLED), items with their production state, prices and the shipping address. There is no list-orders endpoint, so the id must be known (from spod_create_order or the Spreadconnect app). GET /orders/{orderId}.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_get_order_shipments(order_id)
The shipments of an order: carrier, tracking number and link, and which order items each contains. GET /orders/{orderId}/shipments.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_get_order_shipping_types(order_id)
The shipping types available for an order, with id, carrier, name and price. Pick one id for spod_set_order_shipping_type. GET /orders/{orderId}/shippingTypes.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴spod_create_order(external_order_reference, external_order_name, email, phone, items, ...)
WRITE: create a new order in Spreadconnect from article skus (spod_list_articles) and a delivery address. The order is created UNCONFIRMED (state NEW): nothing is produced or charged until it is confirmed with spod_confirm_order, which needs a shipping type first (spod_get_order_shipping_types, spod_set_order_shipping_type). The customer's email and phone are sent to Spreadconnect and the carrier. Prices are what the customer paid (for the invoice/customs), not what you pay Spreadconnect. Calling it twice creates two orders. POST /orders.
入力スキーマ
{
"type": "object",
"properties": {
"external_order_reference": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Your own order number/reference."
},
"external_order_name": {
"description": "Optional display name for the order.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Customer email used for communication."
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 50,
"description": "Customer phone number (required by the API)."
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Variant sku from spod_list_articles / spod_get_article."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"customer_price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "Amount including VAT / sales tax, zero or more."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 currency code, e.g. EUR or USD."
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false,
"description": "What the customer paid for this line (quantity included)."
},
"external_order_item_reference": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"sku",
"quantity",
"customer_price"
],
"additionalProperties": false
}
},
"shipping_address": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"maxLength": 100
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"company": {
"type": "string",
"maxLength": 150
},
"street": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"streetAnnex": {
"description": "Address line 2.",
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. DE or US."
},
"state": {
"description": "2-letter state code; required for the USA and Canada (e.g. CA, NY).",
"type": "string",
"maxLength": 10
},
"zipCode": {
"type": "string",
"maxLength": 20,
"description": "Postal code; may be an empty string for countries without one."
}
},
"required": [
"lastName",
"street",
"city",
"country",
"zipCode"
],
"additionalProperties": false
},
"shipping_customer_price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "Amount including VAT / sales tax, zero or more."
},
"currency": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "ISO 4217 currency code, e.g. EUR or USD."
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false,
"description": "What the customer paid for shipping."
},
"preferred_shipping_type": {
"description": "Preferred shipping speed (default decided by Spreadconnect).",
"type": "string",
"enum": [
"STANDARD",
"PREMIUM",
"EXPRESS"
]
},
"billing_address": {
"description": "Defaults to the shipping address.",
"type": "object",
"properties": {
"firstName": {
"type": "string",
"maxLength": 100
},
"lastName": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"company": {
"type": "string",
"maxLength": 150
},
"street": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"streetAnnex": {
"description": "Address line 2.",
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. DE or US."
},
"state": {
"description": "2-letter state code; required for the USA and Canada (e.g. CA, NY).",
"type": "string",
"maxLength": 10
},
"zipCode": {
"type": "string",
"maxLength": 20,
"description": "Postal code; may be an empty string for countries without one."
}
},
"required": [
"lastName",
"street",
"city",
"country",
"zipCode"
],
"additionalProperties": false
},
"customer_tax_type": {
"type": "string",
"enum": [
"SALESTAX",
"VAT",
"NOT_TAXABLE"
]
}
},
"required": [
"external_order_reference",
"email",
"phone",
"items",
"shipping_address",
"shipping_customer_price"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴spod_set_order_shipping_type(order_id, shipping_type_id)
WRITE: choose the shipping type of an order that is not confirmed yet (ids from spod_get_order_shipping_types). Required before spod_confirm_order. Setting it again replaces the choice. POST /orders/{orderId}/shippingType.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect order id."
},
"shipping_type_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Shipping type id from spod_get_order_shipping_types."
}
},
"required": [
"order_id",
"shipping_type_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴spod_confirm_order(order_id)
WRITE, SPENDS MONEY: confirm an order so Spreadconnect prints and ships it and bills your account for production and shipping. A shipping type must be set first (spod_set_order_shipping_type). After production starts it cannot be undone; before that spod_cancel_order may still work. Only call it when the user clearly asked to place the order. POST /orders/{orderId}/confirm.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴spod_cancel_order(order_id)
WRITE, DESTRUCTIVE: cancel an order. Spreadconnect refuses it once items are in production or sent. A cancelled order cannot be reopened. POST /orders/{orderId}/cancel.
入力スキーマ
{
"type": "object",
"properties": {
"order_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect order id."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_list_product_types(limit, offset)
The Spreadconnect catalog of blank products you can put designs on (t-shirts, hoodies, mugs...): id, name, brand, sizes, colours (appearances), print type, views and print areas. The ids are used to create articles. The reply is large. GET /productTypes.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Return only the first N product types (default 50) to keep the reply small.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 500
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_get_product_type(product_type_id)
One catalog product type with all details: sizes, colours, print areas, views, print type and descriptions. GET /productTypes/{productTypeId}.
入力スキーマ
{
"type": "object",
"properties": {
"product_type_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Product type id (from spod_list_product_types)."
}
},
"required": [
"product_type_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_list_product_categories
The catalog category tree plus the available features, brands and genders. GET /productTypes/categories.
入力スキーマ
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_list_stock(limit, offset)
Available stock for the variants of this point of sale as a map of sku to stock amount, paged. GET /stock.
入力スキーマ
{
"type": "object",
"properties": {
"limit": {
"description": "Results per page, 1-100 (default 50).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page.",
"type": "integer",
"minimum": 0,
"maximum": 1000000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_get_stock_by_sku(sku)
Available stock of one variant by its sku. GET /stock/{sku}.
入力スキーマ
{
"type": "object",
"properties": {
"sku": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Variant sku."
}
},
"required": [
"sku"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢spod_get_stock_by_product_type(product_type_id)
Available stock of every size and colour of one catalog product type. GET /stock/productType/{productTypeId}.
入力スキーマ
{
"type": "object",
"properties": {
"product_type_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Product type id (from spod_list_product_types)."
}
},
"required": [
"product_type_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴spod_upload_design(url)
WRITE: have Spreadconnect download an image from a public URL and store it as a reusable design; returns a designId for spod_create_article. Uploading the same URL again stores another copy. POST /designs/upload.
入力スキーマ
{
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 2000,
"format": "uri",
"description": "Public https URL of the design image (PNG, under 10 MB)."
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴spod_create_article(title, description, variants, configurations, print_type)
WRITE: create an article (a sellable product) from a catalog product type, chosen colours and sizes, and one or more designs placed on views. Get the ids from spod_get_product_type and use designId from spod_upload_design or a public PNG url. Spreadconnect makes the article available in the connected shop integration. Calling it twice creates two articles. Returns the new article id. POST /articles.
入力スキーマ
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"variants": {
"minItems": 1,
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_type_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"appearance_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Colour id from the product type's appearances."
},
"size_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Size id from the product type's sizes."
},
"d2c_price": {
"description": "Retail price for the customer.",
"type": "number",
"minimum": 0,
"maximum": 100000
}
},
"required": [
"product_type_id",
"appearance_id",
"size_id"
],
"additionalProperties": false
}
},
"configurations": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"image": {
"type": "object",
"properties": {
"url": {
"description": "Public https URL of a PNG under 10 MB.",
"type": "string",
"maxLength": 2000,
"format": "uri"
},
"designId": {
"description": "Id returned by spod_upload_design; wins over url when both are given.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"additionalProperties": false
},
"view": {
"type": "string",
"enum": [
"FRONT",
"BACK",
"LEFT",
"RIGHT",
"HOOD_LEFT",
"HOOD_RIGHT"
]
},
"hotspot": {
"description": "Named print position on the view.",
"type": "string",
"enum": [
"FULL_FRONT",
"MEDIUM_FRONT",
"LEFT_CHEST",
"RIGHT_CHEST",
"FULL_BACK",
"MEDIUM_BACK",
"BACK_COLLAR",
"RIGHT",
"LEFT",
"CENTER_CHEST"
]
}
},
"required": [
"image",
"view"
],
"additionalProperties": false
}
},
"print_type": {
"description": "DD (default) or DTF; DTF only for accounts activated for it.",
"type": "string",
"enum": [
"DD",
"DTF"
]
}
},
"required": [
"title",
"description",
"variants",
"configurations"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴spod_delete_article(article_id)
WRITE, DESTRUCTIVE: permanently delete an article from this point of sale. It cannot be restored; existing orders are not affected. DELETE /articles/{articleId}.
入力スキーマ
{
"type": "object",
"properties": {
"article_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Spreadconnect article id (from spod_list_articles)."
}
},
"required": [
"article_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス