PrintPoss MCP by usefulapi

Read stores, products, orders and wallet; create print-on-demand orders in PrintPoss.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
84%
Calidad de los nombres
77%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (1)

  • LOWTool 'printposs_list_wallet_transactions' name length outside 3-30 rangeen printposs_list_wallet_transactions

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~2,118Tokens (definiciones de herramientas)
~2.4 KBTamaño de respuesta típico
Impacto moderado en la atención (1.65% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "printposs": {
      "url": "https://printposs.usefulapi.io/mcp"
    }
  }
}

Puntos de conexión remotos

https://printposs.usefulapi.io/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (7)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢printposs_list_stores(order_by, order_direction, page, per_page)

List the seller's connected stores (for example Shopify or Etsy shops). Use a store id as store_id when creating an order. GET /api/v1/seller/stores.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "order_by": {
      "description": "Sort field.",
      "type": "string",
      "enum": [
        "id",
        "name",
        "type",
        "created_at"
      ]
    },
    "order_direction": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "per_page": {
      "description": "Results per page (max 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢printposs_list_products(order_by, order_direction, page, per_page)

List the print-on-demand products with their variants (device model, colour, product_variant_id). Use a product_variant_id from this list in printposs_create_order. GET /api/v1/seller/products.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "order_by": {
      "description": "Sort field.",
      "type": "string",
      "enum": [
        "id",
        "name",
        "created_at"
      ]
    },
    "order_direction": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "per_page": {
      "description": "Results per page (max 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢printposs_list_orders(include, page, per_page)

List the seller's fulfillment orders with status (order_status, payment_status), external_order_id and totals. GET /api/v1/seller/orders.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "include": {
      "description": "Comma-separated relationships to include: items, packages, costs, refunds (for example 'items,packages').",
      "type": "string"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "per_page": {
      "description": "Results per page (max 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢printposs_get_order(order_number, include)

Get one order by its PrintPoss order_number, with optional items, packages (tracking), costs and refunds. GET /api/v1/seller/orders/{order_number}.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "order_number": {
      "type": "string",
      "minLength": 1,
      "description": "The PrintPoss order number (for example PP26020572410, from printposs_list_orders)."
    },
    "include": {
      "description": "Comma-separated relationships to include: items, packages, costs, refunds (for example 'items,packages').",
      "type": "string"
    }
  },
  "required": [
    "order_number"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢printposs_list_wallet_transactions(type, date_from, date_to, q, order_by, ...)

List wallet transactions (top-ups, order payments, refunds) with balance_after. Use it to check spend per order. GET /api/v1/seller/wallet-transactions.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Filter by transaction type.",
      "type": "string",
      "enum": [
        "topup",
        "order_payment",
        "refund",
        "other"
      ]
    },
    "date_from": {
      "description": "Filter from date (YYYY-MM-DD).",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "date_to": {
      "description": "Filter to date (YYYY-MM-DD).",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "q": {
      "description": "Search in the transaction description (for example an order number).",
      "type": "string"
    },
    "order_by": {
      "description": "Sort field.",
      "type": "string",
      "enum": [
        "created_at",
        "balance_after",
        "amount",
        "type"
      ]
    },
    "order_direction": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "per_page": {
      "description": "Results per page (max 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢printposs_get_webhook_setup

Read which webhook events (order.shipped, package.in_transit, package.delivered) are set up and their URLs. The header secret is not shown. GET /api/v1/seller/webhooks.

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴printposs_create_order(external_order_id, store_id, items, first_name, last_name, ...)

Create a print-on-demand order that PrintPoss prints and ships to the buyer. It charges the seller's PrintPoss wallet and cannot be cancelled by this tool. Use a unique external_order_id: a repeated id is rejected, so a retry cannot double-charge. Get product_variant_id from printposs_list_products and use is_sample=true for a sample order to yourself. Orders with a seller-made shipping label (shipping_label_url) and Amazon FBA orders are not supported here. POST /api/v1/seller/orders.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "external_order_id": {
      "type": "string",
      "minLength": 1,
      "description": "Your own order id. Must be unique in your PrintPoss account."
    },
    "store_id": {
      "description": "Store id from printposs_list_stores.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "items": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "product_variant_id": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Active variant id from printposs_list_products."
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991,
            "description": "Quantity of this variant (at least 1)."
          },
          "design_image_url": {
            "type": "string",
            "format": "uri",
            "description": "Public URL of the design image."
          },
          "mockup_image_url": {
            "type": "string",
            "format": "uri",
            "description": "Public URL of the mockup image."
          }
        },
        "required": [
          "product_variant_id",
          "quantity",
          "design_image_url",
          "mockup_image_url"
        ]
      },
      "description": "Order items (at least one)."
    },
    "first_name": {
      "type": "string",
      "minLength": 1,
      "description": "Buyer first name."
    },
    "last_name": {
      "type": "string",
      "minLength": 1,
      "description": "Buyer last name."
    },
    "address_1": {
      "type": "string",
      "minLength": 1,
      "description": "Buyer address line 1."
    },
    "address_2": {
      "description": "Buyer address line 2.",
      "type": [
        "string",
        "null"
      ]
    },
    "city": {
      "type": "string",
      "minLength": 1,
      "description": "Buyer city."
    },
    "region": {
      "type": "string",
      "minLength": 1,
      "description": "State or region code for the country (for example CA for California)."
    },
    "zip": {
      "type": "string",
      "minLength": 1,
      "description": "Postal or ZIP code."
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO country code (for example US)."
    },
    "email": {
      "description": "Buyer email address.",
      "anyOf": [
        {
          "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,}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "phone": {
      "description": "Buyer phone number.",
      "type": [
        "string",
        "null"
      ]
    },
    "notes": {
      "description": "Internal notes for the order.",
      "type": [
        "string",
        "null"
      ]
    },
    "is_sample": {
      "description": "True for a sample order (for example to test quality).",
      "type": [
        "boolean",
        "null"
      ]
    }
  },
  "required": [
    "external_order_id",
    "items",
    "first_name",
    "last_name",
    "address_1",
    "city",
    "region",
    "zip",
    "country"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada7 herramientas