io.usefulapi/heartland-retail · v1.0.0 · sales-and-crm
Heartland Retail MCP by usefulapi is healthy: it completed an MCP handshake in 1026 ms and exposes 16 tools.
Read items, stock, customers and sales orders; create and update customers in Heartland Retail.
Endpoint: https://heartland-retail.usefulapi.io/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 16 |
| Latency | 1026 ms |
| Last checked (UTC) | 2026-11-08T16:00:28.619Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-08T16:00:28.619Z | Healthy | 1026 |
heartlandretail_whoami | Show the Heartland Retail user behind the API token, and confirm the token works. Use it first when a call returns 401 or 403. Heartland Retail: GET /api/system/whoami. |
heartlandretail_list_items | Search the store's items (products) by text or JSON filter, with cost, price and vendor ids. Heartland Retail: GET /api/items. |
heartlandretail_get_item | Get one item by id: cost, price, financial class and primary vendor. Heartland Retail: GET /api/items/{item_id}. |
heartlandretail_list_inventory_values | Show stock quantities and values, optionally grouped (for example by item_id or location_id) and filtered to one item. Heartland Retail: GET /api/inventory/values. |
heartlandretail_list_locations | List the store's locations (stores, warehouses) with their ids. Heartland Retail: GET /api/locations. |
heartlandretail_list_customers | Search customers by name, email or a JSON filter. Heartland Retail: GET /api/customers. |
heartlandretail_get_customer | Get one customer by id: name, email, default address ids, custom fields and loyalty points. Heartland Retail: GET /api/customers/{customer_id}. |
heartlandretail_create_customer | Create a customer. Give a first name or a last name (or both). Returns the new customer id. Heartland Retail: POST /api/customers. |
heartlandretail_update_customer | Change the name or email of one customer. Only the fields you give change. Heartland Retail: PUT /api/customers/{customer_id}. |
heartlandretail_list_sales_orders | Search sales orders by text or JSON filter (for example a status). Shows customer, status, shipping and totals. Heartland Retail: GET /api/sales/orders. |
heartlandretail_get_sales_order | Get one sales order by id. Heartland Retail: GET /api/sales/orders/{order_id}. |
heartlandretail_list_sales_order_lines | List the lines (items, quantities, prices) of one sales order. Heartland Retail: GET /api/sales/orders/{order_id}/lines. |
heartlandretail_list_sales_invoices | Search sales invoices by text or JSON filter. Heartland Retail: GET /api/sales/invoices. |
heartlandretail_list_sales_tickets | Search point-of-sale tickets (till sales) by text or JSON filter. Heartland Retail: GET /api/sales/tickets. |
heartlandretail_list_vendors | Search purchasing vendors (suppliers) by text or JSON filter. Heartland Retail: GET /api/purchasing/vendors. |
heartlandretail_get_gift_card | Get one gift card by its card number: value and status. Heartland Retail: GET /api/gift_cards/{gift_card_number}. |