Spreadconnect MCP by usefulapi
Read orders, shipments, stock and articles; create, confirm and cancel orders in Spreadconnect.
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": {
"spod": {
"url": "https://spod.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://spod.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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"
}Community
Nachweis