Heartland Retail MCP by usefulapi
io.usefulapi/heartland-retail · v1.5.0 · MCP 2025-11-25
Read items, stock, customers and sales orders; create and update customers in Heartland Retail.
Reachability
reachable
checked 2026-11-21 05:44 UTC
Registry status active
Tools pinned 16
3f4bd73dc69f
Tools last changed
2026-11-21
Repo last push 2026-11-21
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Remote endpoints
https://heartland-retail.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:44 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-11-09 05:30 | first capture | 16 tools pinned |
Pinned tool definitions (16)
| Tool | Description |
|---|---|
| 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}. |
Get alerted when this changes.
Email the moment io.usefulapi/heartland-retail drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/heartland-retail)
Maintain this server? Add the badge to your README. It links your users to this live status page.