Cin7 Core MCP by usefulapi

Read Cin7 Core products, stock by location, sales, purchases, customers, suppliers and transfers.

사용해야 할까요

품질 및 안전성

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

발견 사항 (4)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains suspicious base64-like encoded stringcin7core_list_sales에서
  • LOWTool 'cin7core_get_stock_availability' name length outside 3-30 rangecin7core_get_stock_availability에서
  • LOWTool 'cin7core_list_stock_adjustments' name length outside 3-30 rangecin7core_list_stock_adjustments에서

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

컨텍스트 비용

~4,832토큰 (도구 정의)
~2.2 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 3.77%)

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

설치

원클릭 설치

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

{
  "mcpServers": {
    "cin7-core": {
      "url": "https://cin7-core.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://cin7-core.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (17)

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

The Cin7 Core company these credentials belong to: company name, base currency, time zone, default weight/dimension units, lock date and tax calculation method. Good first call. GET /me.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_locations(name, deprecated_only, page, limit)

List stock locations (warehouses) with their id, name, default flag, address, bins and pick zones. Location names are what the stock-availability and sale/purchase tools use. GET /ref/location.

입력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Only locations whose name starts with this.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "deprecated_only": {
      "description": "true = only deprecated locations.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_products(name, sku, modified_since, include_deprecated, include_suppliers, ...)

List products (active by default): id, SKU, name, category, brand, type (Stock/Service), costing method, unit of measure, barcode, price tiers, average cost, reorder settings, status and description. Filter by name or SKU (contains) or by modification date. GET /product.

입력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Only products whose name contains this.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "sku": {
      "description": "Only products whose SKU contains this.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "modified_since": {
      "description": "Only products changed since this time. YYYY-MM-DD (UTC) or ISO 8601 date-time with zone.",
      "type": "string",
      "maxLength": 40
    },
    "include_deprecated": {
      "description": "true = include deprecated products.",
      "type": "boolean"
    },
    "include_suppliers": {
      "description": "Include each product's suppliers and supplier prices.",
      "type": "boolean"
    },
    "include_reorder_levels": {
      "description": "Include reorder levels per location.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_product(product_id, include_bom, include_suppliers, include_movements, include_attachments, ...)

One product by id (including deprecated ones) with its full detail; optionally its bill of materials, suppliers, stock movements, attachments, reorder levels and customer-specific prices. GET /product?ID=…

입력 스키마

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Product id (GUID, from cin7core_list_products)."
    },
    "include_bom": {
      "description": "Include the bill of materials.",
      "type": "boolean"
    },
    "include_suppliers": {
      "description": "Include suppliers and supplier prices.",
      "type": "boolean"
    },
    "include_movements": {
      "description": "Include stock movements.",
      "type": "boolean"
    },
    "include_attachments": {
      "description": "Include attachments (file names and download links).",
      "type": "boolean"
    },
    "include_reorder_levels": {
      "description": "Include reorder levels per location.",
      "type": "boolean"
    },
    "include_custom_prices": {
      "description": "Include customer-specific prices.",
      "type": "boolean"
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_stock_availability(product_id, name, sku, location, batch, ...)

Stock levels per product, location, bin and batch: on hand, allocated, available, on order, in transit, stock on hand value and next delivery date. Filter by product id, name (starts with), exact SKU, location name, batch/serial number or category. GET /ref/productavailability.

입력 스키마

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "Only this product (GUID).",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    },
    "name": {
      "description": "Only products whose name starts with this.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "sku": {
      "description": "Only the product with exactly this SKU.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "location": {
      "description": "Only stock in this location (exact location name, see cin7core_list_locations).",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "batch": {
      "description": "Only this batch or serial number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "category": {
      "description": "Only products in this category (name).",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_customers(name, contact, modified_since, include_deprecated, page, ...)

List customers (active by default): id, name, display name, currency, payment term, tax rule, price tier, sales rep, location, credit limit and hold, status, addresses and contacts. Filter by name (starts with), contact name/email, or modification date. GET /customer.

입력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Only customers whose name starts with this.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "contact": {
      "description": "Only customers with a contact whose name starts with this or whose email equals this.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "modified_since": {
      "description": "Only customers changed since this time. YYYY-MM-DD (UTC) or ISO 8601 date-time with zone.",
      "type": "string",
      "maxLength": 40
    },
    "include_deprecated": {
      "description": "true = include deprecated customers.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_customer(customer_id, include_product_prices)

One customer by id (including deprecated ones), optionally with its customer-specific product prices. GET /customer?ID=…

입력 스키마

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Customer id (GUID)."
    },
    "include_product_prices": {
      "description": "Include customer-specific product prices.",
      "type": "boolean"
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_suppliers(name, modified_since, include_deprecated, page, limit)

List suppliers (active by default): id, name, currency, payment term, tax rule, discount, status, addresses and contacts. Filter by name (starts with) or modification date. GET /supplier.

입력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Only suppliers whose name starts with this.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "modified_since": {
      "description": "Only suppliers changed since this time. YYYY-MM-DD (UTC) or ISO 8601 date-time with zone.",
      "type": "string",
      "maxLength": 40
    },
    "include_deprecated": {
      "description": "true = include deprecated suppliers.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_supplier(supplier_id)

One supplier by id (including deprecated ones). GET /supplier?ID=…

입력 스키마

{
  "type": "object",
  "properties": {
    "supplier_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Supplier id (GUID)."
    }
  },
  "required": [
    "supplier_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_sales(search, status, created_since, updated_since, updated_until, ...)

List sales (sale orders) with order number, status, customer, order/invoice dates, invoice and paid amounts, currencies, and the quote/order/pick/pack/ship/invoice/payment statuses. Search by order number, customer, invoice number or customer reference; filter by dates and statuses. GET /saleList.

입력 스키마

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Text contained in the order number, status, customer, invoice number, customer reference or credit note number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "status": {
      "description": "Overall sale status.",
      "type": "string",
      "enum": [
        "DRAFT",
        "VOIDED",
        "ESTIMATING",
        "ESTIMATED",
        "ORDERING",
        "ORDERED",
        "BACKORDERED",
        "PICKING",
        "PICKED",
        "PACKING",
        "PACKED",
        "SHIPPING",
        "INVOICING",
        "INVOICED",
        "CREDITED",
        "COMPLETED"
      ]
    },
    "created_since": {
      "description": "Only sales created after this time.",
      "type": "string",
      "maxLength": 40
    },
    "updated_since": {
      "description": "Only sales changed after this time.",
      "type": "string",
      "maxLength": 40
    },
    "updated_until": {
      "description": "Only sales changed before this time.",
      "type": "string",
      "maxLength": 40
    },
    "ship_by": {
      "description": "Only sales with a Ship By date on or before this, not yet shipped.",
      "type": "string",
      "maxLength": 40
    },
    "quote_status": {
      "description": "Quote status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED"
      ]
    },
    "order_status": {
      "description": "Order status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED",
        "AUTH_NO_ALLOC",
        "FULFILLED",
        "CLOSED"
      ]
    },
    "pick_status": {
      "description": "Combined pick status.",
      "type": "string",
      "enum": [
        "VOIDED",
        "NOT AVAILABLE",
        "PICKED",
        "PICKING",
        "NOT PICKED",
        "PARTIALLY PICKED"
      ]
    },
    "pack_status": {
      "description": "Combined pack status.",
      "type": "string",
      "enum": [
        "VOIDED",
        "NOT AVAILABLE",
        "PACKED",
        "PACKING",
        "NOT PACKED",
        "PARTIALLY PACKED"
      ]
    },
    "shipping_status": {
      "description": "Combined shipping status.",
      "type": "string",
      "enum": [
        "VOIDED",
        "NOT AVAILABLE",
        "SHIPPED",
        "SHIPPING",
        "NOT SHIPPED",
        "PARTIALLY SHIPPED"
      ]
    },
    "invoice_status": {
      "description": "Combined invoice status.",
      "type": "string",
      "enum": [
        "VOIDED",
        "DRAFT",
        "AUTHORISED",
        "NOT AVAILABLE",
        "PAID"
      ]
    },
    "credit_note_status": {
      "description": "Credit note status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED"
      ]
    },
    "external_id": {
      "description": "Only sales with this External ID.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "ready_for_shipping": {
      "description": "true = only sales packed but not yet shipped.",
      "type": "boolean"
    },
    "order_location_id": {
      "description": "Only sales from this order location (GUID).",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_sale(sale_id, combine_additional_charges, hide_inventory_movements, include_transactions)

One sale by id with everything on it: customer, contact, addresses, terms, location, notes, quote, order lines, fulfilments (pick/pack/ship and tracking), invoices, credit notes, payments, attachments and inventory movements. GET /sale?ID=…

입력 스키마

{
  "type": "object",
  "properties": {
    "sale_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Sale id (GUID, the SaleID from cin7core_list_sales)."
    },
    "combine_additional_charges": {
      "description": "Show additional charges inside the line arrays.",
      "type": "boolean"
    },
    "hide_inventory_movements": {
      "description": "Leave out inventory movements (smaller reply).",
      "type": "boolean"
    },
    "include_transactions": {
      "description": "Include the related accounting transactions.",
      "type": "boolean"
    }
  },
  "required": [
    "sale_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_purchases(search, status, required_by, updated_since, updated_until, ...)

List purchases (purchase orders) with order number, status, supplier, order/invoice/required-by dates, invoice and paid amounts, currencies, type (simple/advanced/service) and the order/receiving/invoice/payment statuses. GET /purchaseList.

입력 스키마

{
  "type": "object",
  "properties": {
    "search": {
      "description": "Text contained in the order number, status, supplier, invoice number or credit note number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "status": {
      "description": "Overall purchase status.",
      "type": "string",
      "enum": [
        "DRAFT",
        "VOIDED",
        "ORDERING",
        "ORDERED",
        "RECEIVING",
        "RECEIVED",
        "INVOICED",
        "CREDITED",
        "RECEIVING / CREDITED",
        "RECEIVED / CREDITED",
        "PARTIALLY INVOICED",
        "COMPLETED"
      ]
    },
    "required_by": {
      "description": "Only purchases with a Required By date on or before this.",
      "type": "string",
      "maxLength": 40
    },
    "updated_since": {
      "description": "Only purchases changed after this time.",
      "type": "string",
      "maxLength": 40
    },
    "updated_until": {
      "description": "Only purchases changed before this time.",
      "type": "string",
      "maxLength": 40
    },
    "order_status": {
      "description": "Purchase order status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED"
      ]
    },
    "stock_received_status": {
      "description": "Stock received (put away) status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED"
      ]
    },
    "invoice_status": {
      "description": "Invoice status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED",
        "PAID"
      ]
    },
    "credit_note_status": {
      "description": "Credit note status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED"
      ]
    },
    "unstock_status": {
      "description": "Unstock status.",
      "type": "string",
      "enum": [
        "NOT AVAILABLE",
        "DRAFT",
        "AUTHORISED",
        "VOIDED"
      ]
    },
    "drop_ship_sale_id": {
      "description": "Only drop-ship purchases created by this sale (GUID).",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_purchase(purchase_id, combine_additional_charges)

One purchase by id (simple, advanced or service purchase): supplier, contact, addresses, terms, location, required-by date, note, order lines, stock received, put away, invoices, credit notes, payments and attachments. GET /advanced-purchase?ID=… (the vendor endpoint that serves every purchase type).

입력 스키마

{
  "type": "object",
  "properties": {
    "purchase_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Purchase id (GUID, the ID from cin7core_list_purchases)."
    },
    "combine_additional_charges": {
      "description": "Show additional charges inside the line arrays.",
      "type": "boolean"
    }
  },
  "required": [
    "purchase_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_stock_adjustments(status, page, limit)

List stock adjustments: task id, number, effective date, status, expense account, reference and comment. GET /stockadjustmentList.

입력 스키마

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Only adjustments with this status.",
      "type": "string",
      "enum": [
        "DRAFT",
        "COMPLETED",
        "VOIDED"
      ]
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_stock_adjustment(task_id)

One stock adjustment by task id with its lines (product, location, batch, quantity, unit cost) and transactions. GET /stockadjustment?TaskID=…

입력 스키마

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Stock adjustment task id (GUID, from cin7core_list_stock_adjustments)."
    }
  },
  "required": [
    "task_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_list_stock_transfers(status, search, page, limit)

List stock transfers between locations: task id, number, from/to location, status, departure and completion dates, reference. GET /stockTransferList.

입력 스키마

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Only transfers with this status.",
      "type": "string",
      "enum": [
        "DRAFT",
        "IN TRANSIT",
        "COMPLETED",
        "VOIDED"
      ]
    },
    "search": {
      "description": "Text contained in the from/to location, status, reference or number.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "limit": {
      "description": "Records per page, 1-100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢cin7core_get_stock_transfer(task_id)

One stock transfer by task id with its lines (product, quantity, from/to bin, batch) and status. GET /stockTransfer?TaskID=…

입력 스키마

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Stock transfer task id (GUID, from cin7core_list_stock_transfers)."
    }
  },
  "required": [
    "task_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

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