{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "spod.usefulapi.io",
    "site": "usefulapi.io",
    "addresses": [
      {
        "address": "172.67.138.37",
        "endpoints": 946,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.128.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.21.62.184",
        "endpoints": 946,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.32.0/19",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::6815:3eb8",
        "endpoints": 946,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3030::ac43:8a25",
        "endpoints": 946,
        "shared_infrastructure": true,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3030::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.138.37",
          "104.21.62.184",
          "2606:4700:3032::6815:3eb8",
          "2606:4700:3030::ac43:8a25"
        ],
        "first_seen": "2026-11-22T21:35:02.330Z",
        "last_seen": "2026-11-22T21:35:02.330Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "spod-mcp",
      "version": "1.1.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 945,
      "sample": [
        {
          "id": "22186",
          "url": "https://mcp.easyscribe.guide/mcp",
          "server_name": "guide.easyscribe/easy-scribe",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T17:59:02.319Z"
        },
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        }
      ]
    },
    "same_site": {
      "total": 1102,
      "sample": [
        {
          "id": "42087",
          "url": "https://17track.usefulapi.io/mcp",
          "server_name": "io.usefulapi/17track",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:10:01.976Z"
        },
        {
          "id": "42088",
          "url": "https://a2x-accounting.usefulapi.io/mcp",
          "server_name": "io.usefulapi/a2x-accounting",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:11:01.183Z"
        },
        {
          "id": "42089",
          "url": "https://abacus-pos.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abacus-pos",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:12:01.080Z"
        },
        {
          "id": "42090",
          "url": "https://abaninja.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abaninja",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:13:02.135Z"
        },
        {
          "id": "42091",
          "url": "https://ablesign.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ablesign",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:14:01.432Z"
        },
        {
          "id": "42092",
          "url": "https://ably.usefulapi.io/mcp",
          "server_name": "io.usefulapi/ably",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:15:01.611Z"
        },
        {
          "id": "42093",
          "url": "https://abra-flexi.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abra-flexi",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:16:00.986Z"
        },
        {
          "id": "42094",
          "url": "https://absence-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/absence-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:17:01.057Z"
        },
        {
          "id": "42095",
          "url": "https://abstract-api.usefulapi.io/mcp",
          "server_name": "io.usefulapi/abstract-api",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:18:00.734Z"
        },
        {
          "id": "42096",
          "url": "https://academy-of-mine.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academy-of-mine",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:19:00.968Z"
        },
        {
          "id": "42097",
          "url": "https://academyocean.usefulapi.io/mcp",
          "server_name": "io.usefulapi/academyocean",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:20:01.024Z"
        },
        {
          "id": "42098",
          "url": "https://accelo.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accelo",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:21:01.299Z"
        },
        {
          "id": "42099",
          "url": "https://accredible.usefulapi.io/mcp",
          "server_name": "io.usefulapi/accredible",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:22:00.819Z"
        },
        {
          "id": "42100",
          "url": "https://action1.usefulapi.io/mcp",
          "server_name": "io.usefulapi/action1",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:23:00.761Z"
        },
        {
          "id": "42101",
          "url": "https://acube.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acube",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:24:00.644Z"
        },
        {
          "id": "42102",
          "url": "https://acuity-scheduling.usefulapi.io/mcp",
          "server_name": "io.usefulapi/acuity-scheduling",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:25:02.340Z"
        },
        {
          "id": "42103",
          "url": "https://adafruit-io.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adafruit-io",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:26:02.127Z"
        },
        {
          "id": "42104",
          "url": "https://addevent.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addevent",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:27:01.202Z"
        },
        {
          "id": "42105",
          "url": "https://addressfinder.usefulapi.io/mcp",
          "server_name": "io.usefulapi/addressfinder",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:28:00.709Z"
        },
        {
          "id": "42106",
          "url": "https://adminpulse.usefulapi.io/mcp",
          "server_name": "io.usefulapi/adminpulse",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T18:29:00.620Z"
        }
      ]
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.usefulapi",
      "total": 1102,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "same_repository": {
      "repository_url": "https://github.com/m190/usefulapi-mcp",
      "total": 1102,
      "sample": [
        {
          "name": "io.usefulapi/17track",
          "title": "17TRACK MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/a2x-accounting",
          "title": "A2X MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abacus-pos",
          "title": "Abacus POS MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abaninja",
          "title": "AbaNinja MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ablesign",
          "title": "AbleSign MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/ably",
          "title": "Ably MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abra-flexi",
          "title": "ABRA Flexi MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/absence-io",
          "title": "absence.io MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/abstract-api",
          "title": "Abstract API MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academy-of-mine",
          "title": "Academy of Mine MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/academyocean",
          "title": "AcademyOcean MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accelo",
          "title": "Accelo MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/accredible",
          "title": "Accredible MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/action1",
          "title": "Action1 MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acube",
          "title": "A-Cube MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/acuity-scheduling",
          "title": "Acuity Scheduling MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adafruit-io",
          "title": "Adafruit IO MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addevent",
          "title": "AddEvent MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/addressfinder",
          "title": "Addressfinder MCP by usefulapi"
        },
        {
          "name": "io.usefulapi/adminpulse",
          "title": "AdminPulse MCP by usefulapi"
        }
      ]
    },
    "note": "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."
  },
  "endpoint": {
    "id": "42971",
    "server_name": "io.usefulapi/spod",
    "url": "https://spod.usefulapi.io/mcp",
    "host": "spod.usefulapi.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T21:35:02.330Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "0b8c4223ce357a7648835150e750d63c8cc7b4df6a6892d98d20669581ff024b",
    "first_listed_at": "2026-11-22T21:35:02.330Z",
    "created_at": "2026-11-21T12:45:10.780Z",
    "resolved_addresses": [
      "172.67.138.37",
      "104.21.62.184",
      "2606:4700:3032::6815:3eb8",
      "2606:4700:3030::ac43:8a25"
    ]
  },
  "server": {
    "name": "io.usefulapi/spod",
    "title": "Spreadconnect MCP by usefulapi",
    "description": "Read orders, shipments, stock and articles; create, confirm and cancel orders in Spreadconnect.",
    "version": "1.1.0",
    "registry_status": "active",
    "repository_url": "https://github.com/m190/usefulapi-mcp",
    "website_url": "https://usefulapi.io/spod/",
    "published_at": "2026-11-21T01:02:35.997Z",
    "updated_at": "2026-11-21T01:02:35.997Z",
    "first_seen": "2026-11-21T12:45:10.113Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T21:35:11.764Z"
  },
  "operator": {
    "key": "usefulapi.io",
    "name": "usefulapi.io",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 499,
    "first_check_in_window": "2026-11-22T21:35:02.330Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "0b8c4223ce357a7648835150e750d63c8cc7b4df6a6892d98d20669581ff024b",
    "tools": 19,
    "resources": 0,
    "prompts": 6,
    "first_seen": "2026-11-22T21:35:02.844Z",
    "tool_names": [
      "spod_get_account",
      "spod_list_articles",
      "spod_get_article",
      "spod_get_order",
      "spod_get_order_shipments",
      "spod_get_order_shipping_types",
      "spod_create_order",
      "spod_set_order_shipping_type",
      "spod_confirm_order",
      "spod_cancel_order",
      "spod_list_product_types",
      "spod_get_product_type",
      "spod_list_product_categories",
      "spod_list_stock",
      "spod_get_stock_by_sku",
      "spod_get_stock_by_product_type",
      "spod_upload_design",
      "spod_create_article",
      "spod_delete_article"
    ],
    "declared": {
      "tools": [
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "getting_started",
          "description": "What you can do with Spreadconnect here, with example requests to try."
        },
        {
          "name": "check_the_status_and_tracking_of_an_order",
          "description": "Read an order by its Spreadconnect id to see its state and items. Then list its shipments with the carrier and tracking numbers."
        },
        {
          "name": "find_sizes_that_are_out_of_stock",
          "description": "List your articles with their skus, sizes and colours. Then read the stock of those skus to find the sizes that are sold out."
        },
        {
          "name": "place_an_order_and_confirm_it_for_production",
          "description": "Create an unconfirmed order from article skus and a delivery address. Choose a shipping type, then confirm the order only when you approve it, because confirming starts production and bills your account."
        },
        {
          "name": "cancel_an_order_before_production_starts",
          "description": "Read an order to check its state. Cancel it if production has not started, because a cancelled order cannot be reopened."
        },
        {
          "name": "create_a_product_from_a_design_and_a_blank_catalog_item",
          "description": "Read a blank product type with its colours and sizes. Upload a design from a public image URL, then create an article that places it on the product."
        }
      ]
    },
    "instructions": "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."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}