PrintPoss MCP by usefulapi
Read stores, products, orders and wallet; create print-on-demand orders in PrintPoss.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWprintposs_list_wallet_transactions에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"printposs": {
"url": "https://printposs.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://printposs.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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}.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거