PrintPoss MCP by usefulapi
Read stores, products, orders and wallet; create print-on-demand orders in PrintPoss.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen printposs_list_wallet_transactions
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
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-httpQué puede hacer
Inventario de herramientas
Herramientas (7)
🟢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
Evidencia