PrintPoss MCP by usefulapi

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

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
84%
이름 품질
77%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (1)

  • LOWTool 'printposs_list_wallet_transactions' name length outside 3-30 rangeprintposs_list_wallet_transactions에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,118토큰 (도구 정의)
~2.4 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.65%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 7개