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,642トークン数(ツール定義)
~1.2 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 2.85%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `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 件