Mintsoft MCP by usefulapi
Read orders, products, stock, ASNs and returns; add order comments and tags in Mintsoft.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"mintsoft": {
"url": "https://mintsoft.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://mintsoft.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (22)
🟢mintsoft_list_clients(page, limit, since_last_updated)
List clients (the customers of a 3PL warehouse). Mintsoft: GET /api/Client.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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=.
Eingabe-Schema
{
"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"
}Community
Nachweis