Skip to main content
Glama
AhamadFalah

mintsoft-mcp

by AhamadFalah

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MINTSOFT_AUDITNoAudit-log every API call.1
MINTSOFT_API_KEYYesYour Mintsoft API key.
MINTSOFT_AUDIT_LOGNoAudit log path.~/.mintsoft-mcp/mintsoft_api_audit.jsonl
MINTSOFT_SECRET_NAMENoOptional: GCP Secret Manager secret name.
MINTSOFT_ENABLE_WRITESNoRegister the write tools.0
MINTSOFT_SECRET_PROJECTNoOptional: GCP Secret Manager project ID.
MINTSOFT_AUDIT_WRITES_ONLYNoLog only PUT/POST/DELETE.0
MINTSOFT_WRITE_CLIENT_ALLOWLISTNoComma-separated ClientIds writes may touch. Empty = all writes refused.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_orderA

Get full detail for one Mintsoft order by its numeric order ID.

search_ordersA

Search orders by order number. exact=True does an exact match (recommended).

get_order_idC

Resolve an exact order number to its internal Mintsoft order ID.

list_ordersB

List orders by status ID (e.g. NEW=1, DESPATCHED=4, QUERYRAISED=13, AWAITINGPICKING=15, PICKED=17). limit max 100.

list_order_statusesA

List all order status names and their IDs.

get_order_itemsB

Get the line items for an order.

get_order_commentsB

Get the comments logged against an order.

track_order_by_tracking_numberB

Find an order by its courier tracking number.

list_order_channelsA

List the sales channels (Shopify, Amazon, etc.) configured in Mintsoft.

get_productA

Get full detail for one product by its numeric product ID.

lookup_product_idC

Resolve a primary SKU to its internal product ID.

search_productsB

Search products by SKU or name.

list_productsA

List products (paged). limit max 100. client_id filters to one client (0 = all). Unlike search_products, this listing INCLUDES bundles — use it to find a bundle's product ID.

get_alt_codesB

List the alternative SKUs / barcodes (AltCodes) mapped to a product.

get_bundleA

Read a bundle's make-up: SKU, Name, and Components (each with ProductId, SKU, Quantity). NB: bundles are hidden from Product/Search — find them via list_products(client_id=…) or by ID.

get_product_inventoryC

Get inventory (stock by location) for a product.

get_stock_levels_by_warehouseB

Stock levels for a warehouse, for products updated in the last N days (default 31).

get_stock_levels_updated_sinceA

Stock levels for products changed in the last N days (default 7). Prefer this over the full StockLevels (which can time out).

get_stock_flowC

Stock-flow (movement) history for a product over the last N days (default 30).

list_suppliersB

List product suppliers.

precheck_discontinueA

READ-ONLY discontinue footprint for a SKU before retiring it: stock on hand, live-order allocations, inbound/backorder, bundle membership, plus alt-code & replen info. Returns a blocker list and a clear flag. Identify by sku (+client_id) or product_id. Safe on any client.

list_asnsB

List ASNs (inbound goods-in / advance shipping notices).

get_asnB

Get one ASN (inbound) by ID.

list_returnsD

List returns.

get_returnB

Get one return by ID.

list_warehousesC

List warehouses.

list_locationsB

List all storage locations in a warehouse.

list_warehouse_zonesB

List the zones (location-charge zones) of a warehouse.

list_clientsB

List clients (brands) in the account.

list_couriersA

List courier services.

list_invoicesB

List accounting invoices (needs Accounting permission on the API key).

get_invoiceA

Get one invoice by ID (needs Accounting permission).

list_order_rulesA

List order rules (needs OrderRules permission on the API key).

run_reportA

Run a Mintsoft report. kind = 'courier_despatch' | 'products_in_location' | 'product_usage'. Dates are YYYY-MM-DD; default to the last 7 days when omitted. warehouse_id/client_id are optional filters (0 = all).

get_ref_dataB

Reference data. kind = 'countries' | 'currencies' | 'picking_types' | 'price_types'.

mintsoft_getA

Generic READ-ONLY passthrough: GET any Mintsoft API path (e.g. 'Order/123/Shipments'). Path is relative to /api/. Only GETs — for safety this tool cannot perform writes.

get_api_audit_logA

Read the most recent entries from the Mintsoft API audit log — the append-only history of EVERY call this tooling/server makes (ts, method, write flag, path, body, status, success, affected_id). Use to trace or recover from changes. writes_only=True → only PUT/POST/DELETE; contains → only lines whose path/body matches the substring (e.g. a SKU or 'Bundle').

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AhamadFalah/mintsoft-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server