Spreadconnect MCP by usefulapi is an MCP server published by io.usefulapi, hosted at spod.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 19 tools, including spod_get_account, spod_list_articles, spod_get_article, spod_get_order, spod_get_order_shipments.
Read orders, shipments, stock and articles; create, confirm and cancel orders in Spreadconnect.
4,241 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
No parameters.
{
"name": "spod_get_account",
"title": "Get account",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page. |
{
"name": "spod_list_articles",
"title": "List articles",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page."
}
}
},
"annotations": {
"title": "List articles",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One article with all details: variants (sku, size, colour, prices), images and configuration. GET /articles/{articleId}.
| Parameter | Type | Description |
|---|---|---|
| article_id * | integer | Spreadconnect article id (from spod_list_articles). |
{
"name": "spod_get_article",
"title": "Get article",
"description": "One article with all details: variants (sku, size, colour, prices), images and configuration. GET /articles/{articleId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"article_id"
],
"properties": {
"article_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect article id (from spod_list_articles).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get article",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Spreadconnect order id. |
{
"name": "spod_get_order",
"title": "Get order",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect order id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get order",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The shipments of an order: carrier, tracking number and link, and which order items each contains. GET /orders/{orderId}/shipments.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Spreadconnect order id. |
{
"name": "spod_get_order_shipments",
"title": "Get order shipments",
"description": "The shipments of an order: carrier, tracking number and link, and which order items each contains. GET /orders/{orderId}/shipments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect order id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get order shipments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Spreadconnect order id. |
{
"name": "spod_get_order_shipping_types",
"title": "Get order shipping types",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect order id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get order shipping types",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| email * | string | Customer email used for communication. |
| items * | array | |
| phone * | string | Customer phone number (required by the API). |
| billing_address | object | Defaults to the shipping address. |
| shipping_address * | object | |
| customer_tax_type | string | one of ["SALESTAX","VAT","NOT_TAXABLE"] |
| external_order_name | string | Optional display name for the order. |
| preferred_shipping_type | string | Preferred shipping speed (default decided by Spreadconnect). |
| shipping_customer_price * | object | What the customer paid for shipping. |
| external_order_reference * | string | Your own order number/reference. |
{
"name": "spod_create_order",
"title": "Create order (unconfirmed)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"external_order_reference",
"email",
"phone",
"items",
"shipping_address",
"shipping_customer_price"
],
"properties": {
"email": {
"type": "string",
"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,}$",
"maxLength": 254,
"description": "Customer email used for communication."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"sku",
"quantity",
"customer_price"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Variant sku from spod_list_articles / spod_get_article."
},
"quantity": {
"type": "integer",
"maximum": 10000,
"minimum": 1
},
"customer_price": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"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."
}
},
"description": "What the customer paid for this line (quantity included).",
"additionalProperties": false
},
"external_order_item_reference": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"phone": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Customer phone number (required by the API)."
},
"billing_address": {
"type": "object",
"required": [
"lastName",
"street",
"city",
"country",
"zipCode"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 10,
"description": "2-letter state code; required for the USA and Canada (e.g. CA, NY)."
},
"street": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"company": {
"type": "string",
"maxLength": 150
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. DE or US."
},
"zipCode": {
"type": "string",
"maxLength": 20,
"description": "Postal code; may be an empty string for countries without one."
},
"lastName": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"firstName": {
"type": "string",
"maxLength": 100
},
"streetAnnex": {
"type": "string",
"maxLength": 200,
"description": "Address line 2."
}
},
"description": "Defaults to the shipping address.",
"additionalProperties": false
},
"shipping_address": {
"type": "object",
"required": [
"lastName",
"street",
"city",
"country",
"zipCode"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 10,
"description": "2-letter state code; required for the USA and Canada (e.g. CA, NY)."
},
"street": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"company": {
"type": "string",
"maxLength": 150
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. DE or US."
},
"zipCode": {
"type": "string",
"maxLength": 20,
"description": "Postal code; may be an empty string for countries without one."
},
"lastName": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"firstName": {
"type": "string",
"maxLength": 100
},
"streetAnnex": {
"type": "string",
"maxLength": 200,
"description": "Address line 2."
}
},
"additionalProperties": false
},
"customer_tax_type": {
"enum": [
"SALESTAX",
"VAT",
"NOT_TAXABLE"
],
"type": "string"
},
"external_order_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Optional display name for the order."
},
"preferred_shipping_type": {
"enum": [
"STANDARD",
"PREMIUM",
"EXPRESS"
],
"type": "string",
"description": "Preferred shipping speed (default decided by Spreadconnect)."
},
"shipping_customer_price": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"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."
}
},
"description": "What the customer paid for shipping.",
"additionalProperties": false
},
"external_order_reference": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Your own order number/reference."
}
}
},
"annotations": {
"title": "Create order (unconfirmed)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Spreadconnect order id. |
| shipping_type_id * | string | Shipping type id from spod_get_order_shipping_types. |
{
"name": "spod_set_order_shipping_type",
"title": "Set order shipping type",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"shipping_type_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect order id.",
"exclusiveMinimum": 0
},
"shipping_type_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Shipping type id from spod_get_order_shipping_types."
}
}
},
"annotations": {
"title": "Set order shipping type",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Spreadconnect order id. |
{
"name": "spod_confirm_order",
"title": "Confirm order (sends it to production)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect order id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Confirm order (sends it to production)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | Spreadconnect order id. |
{
"name": "spod_cancel_order",
"title": "Cancel order",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect order id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Cancel order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Return only the first N product types (default 50) to keep the reply small. |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page. |
{
"name": "spod_list_product_types",
"title": "List product types",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Return only the first N product types (default 50) to keep the reply small.",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page."
}
}
},
"annotations": {
"title": "List product types",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One catalog product type with all details: sizes, colours, print areas, views, print type and descriptions. GET /productTypes/{productTypeId}.
| Parameter | Type | Description |
|---|---|---|
| product_type_id * | integer | Product type id (from spod_list_product_types). |
{
"name": "spod_get_product_type",
"title": "Get product type",
"description": "One catalog product type with all details: sizes, colours, print areas, views, print type and descriptions. GET /productTypes/{productTypeId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_type_id"
],
"properties": {
"product_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Product type id (from spod_list_product_types).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get product type",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The catalog category tree plus the available features, brands and genders. GET /productTypes/categories.
No parameters.
{
"name": "spod_list_product_categories",
"title": "List product categories",
"description": "The catalog category tree plus the available features, brands and genders. GET /productTypes/categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List product categories",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Available stock for the variants of this point of sale as a map of sku to stock amount, paged. GET /stock.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1-100 (default 50). |
| offset | integer | Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page. |
{
"name": "spod_list_stock",
"title": "List stock",
"description": "Available stock for the variants of this point of sale as a map of sku to stock amount, paged. GET /stock.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 1000000,
"minimum": 0,
"description": "Number of results to skip (default 0). Pass the previous reply's next_offset to get the next page."
}
}
},
"annotations": {
"title": "List stock",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Available stock of one variant by its sku. GET /stock/{sku}.
| Parameter | Type | Description |
|---|---|---|
| sku * | string | Variant sku. |
{
"name": "spod_get_stock_by_sku",
"title": "Get stock for a sku",
"description": "Available stock of one variant by its sku. GET /stock/{sku}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"sku"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Variant sku."
}
}
},
"annotations": {
"title": "Get stock for a sku",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Available stock of every size and colour of one catalog product type. GET /stock/productType/{productTypeId}.
| Parameter | Type | Description |
|---|---|---|
| product_type_id * | integer | Product type id (from spod_list_product_types). |
{
"name": "spod_get_stock_by_product_type",
"title": "Get stock for a product type",
"description": "Available stock of every size and colour of one catalog product type. GET /stock/productType/{productTypeId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_type_id"
],
"properties": {
"product_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Product type id (from spod_list_product_types).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get stock for a product type",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Public https URL of the design image (PNG, under 10 MB). |
{
"name": "spod_upload_design",
"title": "Upload design from URL",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2000,
"description": "Public https URL of the design image (PNG, under 10 MB)."
}
}
},
"annotations": {
"title": "Upload design from URL",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| title * | string | |
| variants * | array | |
| print_type | string | DD (default) or DTF; DTF only for accounts activated for it. |
| description * | string | |
| configurations * | array |
{
"name": "spod_create_article",
"title": "Create article",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title",
"description",
"variants",
"configurations"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"variants": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_type_id",
"appearance_id",
"size_id"
],
"properties": {
"size_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Size id from the product type's sizes.",
"exclusiveMinimum": 0
},
"d2c_price": {
"type": "number",
"maximum": 100000,
"minimum": 0,
"description": "Retail price for the customer."
},
"appearance_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Colour id from the product type's appearances.",
"exclusiveMinimum": 0
},
"product_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"print_type": {
"enum": [
"DD",
"DTF"
],
"type": "string",
"description": "DD (default) or DTF; DTF only for accounts activated for it."
},
"description": {
"type": "string",
"maxLength": 5000,
"minLength": 1
},
"configurations": {
"type": "array",
"items": {
"type": "object",
"required": [
"image",
"view"
],
"properties": {
"view": {
"enum": [
"FRONT",
"BACK",
"LEFT",
"RIGHT",
"HOOD_LEFT",
"HOOD_RIGHT"
],
"type": "string"
},
"image": {
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2000,
"description": "Public https URL of a PNG under 10 MB."
},
"designId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Id returned by spod_upload_design; wins over url when both are given."
}
},
"additionalProperties": false
},
"hotspot": {
"enum": [
"FULL_FRONT",
"MEDIUM_FRONT",
"LEFT_CHEST",
"RIGHT_CHEST",
"FULL_BACK",
"MEDIUM_BACK",
"BACK_COLLAR",
"RIGHT",
"LEFT",
"CENTER_CHEST"
],
"type": "string",
"description": "Named print position on the view."
}
},
"additionalProperties": false
},
"maxItems": 10,
"minItems": 1
}
}
},
"annotations": {
"title": "Create article",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE, DESTRUCTIVE: permanently delete an article from this point of sale. It cannot be restored; existing orders are not affected. DELETE /articles/{articleId}.
| Parameter | Type | Description |
|---|---|---|
| article_id * | integer | Spreadconnect article id (from spod_list_articles). |
{
"name": "spod_delete_article",
"title": "Delete article",
"description": "WRITE, DESTRUCTIVE: permanently delete an article from this point of sale. It cannot be restored; existing orders are not affected. DELETE /articles/{articleId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"article_id"
],
"properties": {
"article_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Spreadconnect article id (from spod_list_articles).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Delete article",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Spreadconnect, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "What is the status of Spreadconnect order 123456 and has it shipped?"; "Which of my Spreadconnect articles have sizes that are out of stock?"; "Show the tracking numbers for order 123456.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Spreadconnect data. Free plan: 50 tool calls per month. Run spod_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run spod_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run spod_upgrade without a plan: it returns both plans, each with a payment link for the user to open. spod_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.