# Mintsoft MCP by usefulapi

> Mintsoft MCP by usefulapi is an MCP server. Read orders, products, stock, ASNs and returns; add order comments and tags in Mintsoft. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/mintsoft/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/mintsoft
- **MCP Registry name:** io.usefulapi/mintsoft
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mintsoft https://mintsoft.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mintsoft.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mintsoft": {
      "type": "http",
      "url": "https://mintsoft.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mintsoft": {
      "serverUrl": "https://mintsoft.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mintsoft": {
      "type": "http",
      "url": "https://mintsoft.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `mintsoft_list_clients`: List clients (the customers of a 3PL warehouse). Mintsoft: GET /api/Client.
- `mintsoft_list_warehouses`: List warehouses with their ids. Use the ids for stock and order filters. Mintsoft: GET /api/Warehouse.
- `mintsoft_list_courier_services`: List courier services with ids (for the order filter CourierServiceId). Mintsoft: GET /api/Courier/Services.
- `mintsoft_list_order_statuses`: List order statuses with ids (for the order filter OrderStatusId). Mintsoft: GET /api/Order/Statuses.
- `mintsoft_list_asn_statuses`: List ASN (inbound shipment) statuses with ids. Mintsoft: GET /api/ASN/Statuses.
- `mintsoft_list_orders`: 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.
- `mintsoft_search_orders`: Find orders by order number, tracking number or external order reference. Returns up to 10 orders, newest first. Mintsoft: GET /api/Order/Search.
- `mintsoft_get_order`: Get one order by its Mintsoft order id, with address, status, courier and items. Mintsoft: GET /api/Order/{id}.
- `mintsoft_get_order_comments`: List the comments on an order. Mintsoft: GET /api/Order/{id}/Comments.
- `mintsoft_get_order_shipments`: List the shipments of an order (courier, tracking numbers, parcels). Mintsoft: GET /api/Order/{id}/Shipments.
- `mintsoft_list_products`: List products (SKUs), 100 per page. Mintsoft: GET /api/Product/List.
- `mintsoft_search_products`: Search products by SKU or name. Mintsoft: GET /api/Product/Search.
- `mintsoft_get_product`: Get one product by its Mintsoft product id. Mintsoft: GET /api/Product/{id}.
- `mintsoft_get_stock_levels`: 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.
- `mintsoft_get_product_inventory`: Get the inventory records (locations and quantities) of one product. Mintsoft: GET /api/Product/{id}/Inventory.
- `mintsoft_list_stock_movements`: List the stock movements in one warehouse, optionally for one product or since a date. Mintsoft: GET /api/Warehouse/{id}/StockMovements.
- `mintsoft_list_asns`: List ASNs (advance shipping notices: inbound stock). Mintsoft: GET /api/ASN/List.
- `mintsoft_get_asn`: Get one ASN by id, with items and status. Mintsoft: GET /api/ASN/{id}.
- `mintsoft_list_returns`: List customer returns. Mintsoft: GET /api/Return/List.
- `mintsoft_get_return`: Get one return by id. Mintsoft: GET /api/Return/{id}.
- `mintsoft_add_order_comment`: 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.
- `mintsoft_add_order_tag`: WRITE: add a tag to an order. Adding a tag that exists is safe to repeat. Mintsoft: PUT /api/Order/{id}/Tag?Tag=.

## FAQ

### How do I add Mintsoft MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http mintsoft https://mintsoft.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/mintsoft-mcp-by-usefulapi
