MCP MeasureMCP Measure

索引已觀測

Mintsoft MCP by usefulapi

Read orders, products, stock, ASNs and returns; add order comments and tags in Mintsoft.

我該用這個嗎

品質與安全性

A
說明品質
100%
結構描述完整度
84%
命名品質
100%
汙染風險
100%
權限相符程度
100%
協定合規性
100%

根據工具定義與協定合規性的自動化分析。

上下文成本

~3,642Token（工具定義）
~1.2 KB典型回應大小
顯著的注意力影響（128k 上下文的 2.85%）

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `claude_desktop_config.json` 檔案：

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

遠端端點

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

它能做什麼

工具清單

工具（22）

🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢mintsoft_list_clients(page, limit, since_last_updated)

List clients (the customers of a 3PL warehouse). Mintsoft: GET /api/Client.

輸入結構描述

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Results per page (max 100, default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    },
    "since_last_updated": {
      "description": "ISO date or date-time, e.g. 2026-10-01 or 2026-10-01T08:00:00.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_warehouses

List warehouses with their ids. Use the ids for stock and order filters. Mintsoft: GET /api/Warehouse.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_courier_services

List courier services with ids (for the order filter CourierServiceId). Mintsoft: GET /api/Courier/Services.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_order_statuses

List order statuses with ids (for the order filter OrderStatusId). Mintsoft: GET /api/Order/Statuses.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_asn_statuses

List ASN (inbound shipment) statuses with ids. Mintsoft: GET /api/ASN/Statuses.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_orders(order_status_id, client_id, channel_id, courier_service_id, warehouse_id, ...)

List orders, newest first unless sort_oldest_first. Filter by status, client, warehouse, courier service, dates and tags. Use a 0 id for 'all'. Mintsoft: GET /api/Order/List.

輸入結構描述

{
  "type": "object",
  "properties": {
    "order_status_id": {
      "description": "Order status id (0 = all). See mintsoft_list_order_statuses.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "client_id": {
      "description": "Client id (0 = all).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "channel_id": {
      "description": "Channel id (0 = all).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "courier_service_id": {
      "description": "Courier service id (0 = all).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "warehouse_id": {
      "description": "Warehouse id (0 = all).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "since_date": {
      "description": "Only orders with an order date on or after this date.",
      "type": "string"
    },
    "to_date": {
      "description": "Only orders with an order date on or before this date.",
      "type": "string"
    },
    "since_last_updated": {
      "description": "Only orders updated on or after this date.",
      "type": "string"
    },
    "since_despatch_date": {
      "description": "Only orders despatched on or after this date.",
      "type": "string"
    },
    "include_tags": {
      "description": "Comma-separated tags; only orders with these tags.",
      "type": "string"
    },
    "exclude_tags": {
      "description": "Comma-separated tags; leave out orders with these tags.",
      "type": "string"
    },
    "include_order_items": {
      "description": "Include order items (larger response).",
      "type": "boolean"
    },
    "b2b_only": {
      "description": "Only B2B orders.",
      "type": "boolean"
    },
    "sort_oldest_first": {
      "description": "Sort oldest first.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Results per page (max 100, default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_search_orders(term, exact_match, include_order_items)

Find orders by order number, tracking number or external order reference. Returns up to 10 orders, newest first. Mintsoft: GET /api/Order/Search.

輸入結構描述

{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "minLength": 1,
      "description": "Order number, tracking number or external reference."
    },
    "exact_match": {
      "description": "true = exact match; default = contains.",
      "type": "boolean"
    },
    "include_order_items": {
      "description": "Include order items.",
      "type": "boolean"
    }
  },
  "required": [
    "term"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_order(order_id)

Get one order by its Mintsoft order id, with address, status, courier and items. Mintsoft: GET /api/Order/{id}.

輸入結構描述

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Mintsoft order id (from mintsoft_list_orders or mintsoft_search_orders)."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_order_comments(order_id)

List the comments on an order. Mintsoft: GET /api/Order/{id}/Comments.

輸入結構描述

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Mintsoft order id."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_order_shipments(order_id)

List the shipments of an order (courier, tracking numbers, parcels). Mintsoft: GET /api/Order/{id}/Shipments.

輸入結構描述

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Mintsoft order id."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_products(client_id, since_last_updated, page, limit)

List products (SKUs), 100 per page. Mintsoft: GET /api/Product/List.

輸入結構描述

{
  "type": "object",
  "properties": {
    "client_id": {
      "description": "Client id (3PL admin users only).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "since_last_updated": {
      "description": "ISO date or date-time, e.g. 2026-10-01 or 2026-10-01T08:00:00.",
      "type": "string"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Results per page (max 100, default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_search_products(search, include_bundles, include_discontinued)

Search products by SKU or name. Mintsoft: GET /api/Product/Search.

輸入結構描述

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string",
      "minLength": 1,
      "description": "Text to find in the SKU or name."
    },
    "include_bundles": {
      "type": "boolean"
    },
    "include_discontinued": {
      "type": "boolean"
    }
  },
  "required": [
    "search"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_product(product_id)

Get one product by its Mintsoft product id. Mintsoft: GET /api/Product/{id}.

輸入結構描述

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Mintsoft product id."
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_stock_levels(warehouse_id, product_id, sku, client_id, include_subclients, ...)

Get stock levels, optionally for one warehouse, product or SKU, with a breakdown by batch, serial or best-before date. Mintsoft: GET /api/Product/StockLevels.

輸入結構描述

{
  "type": "object",
  "properties": {
    "warehouse_id": {
      "description": "Warehouse id.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "product_id": {
      "description": "Product id.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "sku": {
      "description": "Product SKU.",
      "type": "string"
    },
    "client_id": {
      "description": "Client id.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "include_subclients": {
      "type": "boolean"
    },
    "breakdown": {
      "description": "Include the breakdown of each stock holding.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_product_inventory(product_id, breakdown)

Get the inventory records (locations and quantities) of one product. Mintsoft: GET /api/Product/{id}/Inventory.

輸入結構描述

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Mintsoft product id."
    },
    "breakdown": {
      "description": "Include the breakdown of each stock holding.",
      "type": "boolean"
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_stock_movements(warehouse_id, product_id, since_date, page, limit)

List the stock movements in one warehouse, optionally for one product or since a date. Mintsoft: GET /api/Warehouse/{id}/StockMovements.

輸入結構描述

{
  "type": "object",
  "properties": {
    "warehouse_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Warehouse id."
    },
    "product_id": {
      "description": "Product id.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "since_date": {
      "description": "ISO date or date-time, e.g. 2026-10-01 or 2026-10-01T08:00:00.",
      "type": "string"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Results per page (max 100, default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "warehouse_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_asns(asn_status_id, client_id, warehouse_id, since_last_updated, include_items, ...)

List ASNs (advance shipping notices: inbound stock). Mintsoft: GET /api/ASN/List.

輸入結構描述

{
  "type": "object",
  "properties": {
    "asn_status_id": {
      "description": "Status id, or ids separated by ';' (e.g. 1;2;4).",
      "type": "string",
      "pattern": "^\\d+(;\\d+)*$"
    },
    "client_id": {
      "description": "Client id (3PL admin users only).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "warehouse_id": {
      "description": "Warehouse id.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "since_last_updated": {
      "description": "ISO date or date-time, e.g. 2026-10-01 or 2026-10-01T08:00:00.",
      "type": "string"
    },
    "include_items": {
      "description": "Include the ASN items.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Results per page (max 100, default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_asn(asn_id)

Get one ASN by id, with items and status. Mintsoft: GET /api/ASN/{id}.

輸入結構描述

{
  "type": "object",
  "properties": {
    "asn_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "ASN id."
    }
  },
  "required": [
    "asn_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_list_returns(client_id, warehouse_id, confirmed, external_only, since_last_updated, ...)

List customer returns. Mintsoft: GET /api/Return/List.

輸入結構描述

{
  "type": "object",
  "properties": {
    "client_id": {
      "description": "Client id (0 = all).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "warehouse_id": {
      "description": "Warehouse id (0 = all).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "confirmed": {
      "description": "Only confirmed (true) or unconfirmed (false) returns.",
      "type": "boolean"
    },
    "external_only": {
      "description": "Only external returns.",
      "type": "boolean"
    },
    "since_last_updated": {
      "description": "ISO date or date-time, e.g. 2026-10-01 or 2026-10-01T08:00:00.",
      "type": "string"
    },
    "include_items": {
      "description": "Include the return items.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "description": "Results per page (max 100, default 100).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢mintsoft_get_return(return_id)

Get one return by id. Mintsoft: GET /api/Return/{id}.

輸入結構描述

{
  "type": "object",
  "properties": {
    "return_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Return id."
    }
  },
  "required": [
    "return_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴mintsoft_add_order_comment(order_id, comment, admin)

WRITE: add a comment to an order. Each call adds one more comment (not idempotent). Set admin true for an internal admin comment. Mintsoft: POST /api/Order/{id}/Comments.

輸入結構描述

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Mintsoft order id."
    },
    "comment": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "The comment text."
    },
    "admin": {
      "description": "true = admin-only comment.",
      "type": "boolean"
    }
  },
  "required": [
    "order_id",
    "comment"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡mintsoft_add_order_tag(order_id, tag)

WRITE: add a tag to an order. Adding a tag that exists is safe to repeat. Mintsoft: PUT /api/Order/{id}/Tag?Tag=.

輸入結構描述

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Mintsoft order id."
    },
    "tag": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "The tag to add."
    }
  },
  "required": [
    "order_id",
    "tag"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

社群

為此伺服器評分

證據

近期觀測

已驗證未記錄版本22 個工具