ConsignCloud MCP by usefulapi

Read items, sales, accounts and store totals; add items and item notes in ConsignCloud.

사용해야 할까요

품질 및 안전성

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

발견 사항 (1)

  • LOWTool 'consigncloud_list_item_categories' name length outside 3-30 rangeconsigncloud_list_item_categories에서

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

컨텍스트 비용

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

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

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (13)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢consigncloud_get_store

Get the store the API key belongs to: name, currency, default split and terms, and billing details. Good first call to confirm which store is connected. ConsignCloud API: GET /store.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_list_items(search, status, account, location, limit, ...)

List inventory items with status, tag price, quantity, consignor account and location. Filter by status, account or location, or search text. Deleted items are hidden. ConsignCloud API: GET /items.

입력 스키마

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Narrow items by a text query.",
      "type": "string"
    },
    "status": {
      "description": "Only items with one of these statuses, e.g. 'active', 'sold', 'expired'.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "sold",
          "active",
          "expired",
          "pending_on_shopify",
          "sold_on_shopify",
          "sold_on_square",
          "sold_on_third_party",
          "to_be_returned",
          "returned_to_owner",
          "donated",
          "lost",
          "stolen",
          "damaged",
          "parked",
          "on_layaway",
          "inactive"
        ]
      }
    },
    "account": {
      "description": "Only items supplied by these account ids.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "location": {
      "description": "Only items at these location ids.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "description": "Items per page, 1-100 (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page. Repeat the same filters with it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_get_item(item_id)

Get one inventory item by id: price, cost, quantity, status, account, location and history. ConsignCloud API: GET /items/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "The item id (a UUID from a list tool)."
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴consigncloud_create_item(quantity, title, description, account, category, ...)

Create one inventory item. Prices and cost are integers in the smallest currency unit (cents for USD: 1250 = 12.50). Account is required for consignment and buy-outright items. Creates a new record each call; it does not check for duplicates. ConsignCloud API: POST /items.

입력 스키마

{
  "type": "object",
  "properties": {
    "quantity": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Units in stock."
    },
    "title": {
      "description": "Item title. If omitted, ConsignCloud builds it from the store template.",
      "type": "string"
    },
    "description": {
      "description": "Longer description. May contain markdown.",
      "type": "string"
    },
    "account": {
      "description": "Account id of the supplier (consignor or vendor).",
      "type": "string"
    },
    "category": {
      "description": "Item category id.",
      "type": "string"
    },
    "location": {
      "description": "Location id.",
      "type": "string"
    },
    "tag_price": {
      "description": "Tag price in cents (USD).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "split_price": {
      "description": "Split price in cents (USD).",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "cost_per": {
      "description": "Cost per unit in cents (USD). Needed for buy-outright and retail items.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "split": {
      "description": "Percent of the split price for the consignor. Consignment only.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "sku": {
      "description": "SKU. Leave empty to let ConsignCloud generate one.",
      "type": "string"
    },
    "brand": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "size": {
      "type": "string"
    }
  },
  "required": [
    "quantity"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_list_sales(search, sort_by, sort_order, limit, cursor)

List sales with totals, status, cashier, register and the consignor and store portions. Search by sale number. ConsignCloud API: GET /sales.

입력 스키마

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Narrow sales by sale number by a text query.",
      "type": "string"
    },
    "sort_by": {
      "description": "Field to sort by.",
      "type": "string",
      "enum": [
        "number",
        "status",
        "created",
        "customer",
        "register",
        "cashier",
        "finalized",
        "parked",
        "voided",
        "subtotal",
        "total",
        "change",
        "consignor_portion",
        "store_portion"
      ]
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Items per page, 1-100 (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page. Repeat the same filters with it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_get_sale(sale_id)

Get one sale by id: line items, payments, taxes, discounts, totals and status. ConsignCloud API: GET /sales/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "sale_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "The sale id (a UUID from a list tool)."
    }
  },
  "required": [
    "sale_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_get_sales_summary(start_date, end_date, channel)

Get sales totals for the store over a date range, bucketed for a histogram. Use it for trends by day or week. ConsignCloud API: GET /reports/sales-summary.

입력 스키마

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "minLength": 1,
      "description": "Start of the range (ISO date, yyyy-mm-dd)."
    },
    "end_date": {
      "type": "string",
      "minLength": 1,
      "description": "End of the range (ISO date, yyyy-mm-dd)."
    },
    "channel": {
      "description": "Only sales from these channels. Omit for all channels.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "consign_cloud",
          "shopify",
          "square"
        ]
      }
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_list_accounts(search, limit, cursor)

List consignor and vendor accounts with balance, item count, default split and contact details. Search by name, email or number. ConsignCloud API: GET /accounts.

입력 스키마

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Narrow accounts by a text query.",
      "type": "string"
    },
    "limit": {
      "description": "Items per page, 1-100 (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page. Repeat the same filters with it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_get_account(account_id)

Get one account by id: balance, default split, contact details, locations and custom fields. ConsignCloud API: GET /accounts/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "account_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "The account id (a UUID from a list tool)."
    }
  },
  "required": [
    "account_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴consigncloud_add_item_note(item_id, body)

Add a markdown note to an inventory item. Adds a record; it does not change the item. ConsignCloud API: POST /items/{id}/notes.

입력 스키마

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      "description": "The item id (a UUID from a list tool)."
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "description": "Note text. May contain markdown."
    }
  },
  "required": [
    "item_id",
    "body"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_list_locations(limit, cursor)

List the store's locations (for example, shops or rooms). ConsignCloud API: GET /locations.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Items per page, 1-100 (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page. Repeat the same filters with it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_list_item_categories(limit, cursor)

List the store's item categories. Use the ids as the category field of consigncloud_create_item. ConsignCloud API: GET /item-categories.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Items per page, 1-100 (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "next_cursor from the previous page. Repeat the same filters with it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢consigncloud_search(query)

Search across the store's records (items, accounts, sales and more) with one text query. ConsignCloud API: GET /search.

입력 스키마

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Text to search for, for example a SKU, a name or a sale number."
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

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