Heartland Retail MCP by usefulapi MCP Server

by usefulapi Your server? Claim it

answering

Heartland Retail MCP by usefulapi is answering right now. Last checked 4 min ago. It exposes 16 tools. Last commit 8 Nov 2026.

Read items, stock, customers and sales orders; create and update customers in Heartland Retail.

Uptime history 9 hours of history

9 hours agonow

100.0%

Uptime 24h

32 of 32 checks

Tools

read from the server

261 ms

Response time

average over 24h

Stars

last commit 8 Nov 2026

Nothing serious here today

Today is the operative word: we check Heartland Retail MCP by usefulapi every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 4 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add heartland-retail --transport http https://heartland-retail.usefulapi.io/mcp

Settings → Connectors → Add custom connector, then paste this address

https://heartland-retail.usefulapi.io/mcp

~/.codex/config.toml

[mcp_servers.heartland-retail]
url = "https://heartland-retail.usefulapi.io/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "heartland-retail": {
      "url": "https://heartland-retail.usefulapi.io/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "heartland-retail": {
      "type": "http",
      "url": "https://heartland-retail.usefulapi.io/mcp"
    }
  }
}

Available tools 16

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

heartlandretail

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_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_get_gift_card

Get one gift card by its card number: value and status. Heartland Retail: GET /api/gift_cards/{gift_card_number}.

heartlandretail_get_item

Get one item by id: cost, price, financial class and primary vendor. Heartland Retail: GET /api/items/{item_id}.

heartlandretail_get_sales_order

Get one sales order by id. Heartland Retail: GET /api/sales/orders/{order_id}.

heartlandretail_list_customers

Search customers by name, email or a JSON filter. Heartland Retail: GET /api/customers.

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_items

Search the store's items (products) by text or JSON filter, with cost, price and vendor ids. Heartland Retail: GET /api/items.

heartlandretail_list_locations

List the store's locations (stores, warehouses) with their ids. Heartland Retail: GET /api/locations.

heartlandretail_list_sales_invoices

Search sales invoices by text or JSON filter. Heartland Retail: GET /api/sales/invoices.

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_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_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_update_customer

Change the name or email of one customer. Only the fields you give change. Heartland Retail: PUT /api/customers/{customer_id}.

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.

Endpoints

URL	Transport	State	Latency	Checked
https://heartland-retail.usefulapi.io/mcp	streamable-http	answering	253 ms	4 min ago

Alternatives to Heartland Retail MCP by usefulapi

same job, measured the same way

SOS Inventory MCP by usefulapi

by usefulapi

Read SOS Inventory stock and orders; create customers, items and purchase or sales orders.

19 tools answering

Lightspeed Retail (R-Series) MCP by usefulapi

by usefulapi

Read Lightspeed R-Series items, stock, sales, customers and POs; create customers and set stock.

18 tools answering

Ginesys MCP by usefulapi

by usefulapi

Look up items; create sales orders; reserve and cancel order stock in Ginesys.

4 tools answering

KiotViet MCP by usefulapi

by usefulapi

Read KiotViet products, customers, invoices, orders and stock; create customers and orders.

29 tools answering

Billogram MCP by usefulapi

by usefulapi

Read invoices, customers, items and balances; create invoices, customers and items in Billogram.

12 tools answering

Sello MCP by usefulapi

by usefulapi

Read orders, products, messages and sales stats; update orders and product stock in Sello.

21 tools answering

STEL Order MCP by usefulapi

by usefulapi

Read clients, invoices, orders and stock; create or update clients, add contacts in STEL Order.

16 tools answering

FieldEdge MCP by usefulapi

by usefulapi

Read work orders, customers and invoices; create customers, notes and work orders in FieldEdge.

45 tools answering

Heartland Retail MCP by usefulapi — questions

Answers built from our own checks of this server.

What can Heartland Retail MCP by usefulapi do?

It exposes 16 tools, read directly from the server on our last check. Among them: heartlandretail_create_customer, heartlandretail_get_customer, heartlandretail_get_gift_card, heartlandretail_get_item, heartlandretail_get_sales_order, heartlandretail_list_customers and 10 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Heartland Retail MCP by usefulapi working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 32 of 32 checks got a reply (100.0%), average response time 261 ms. The bar chart above shows every period we have measured.

How do I connect Heartland Retail MCP by usefulapi?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Heartland Retail MCP by usefulapi need an API key?

No. Heartland Retail MCP by usefulapi completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 16 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Heartland Retail MCP by usefulapi?

It answers our handshake in 261 ms on average, which is faster than 52% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Heartland Retail MCP by usefulapi open source?

The code is open source: it is published under the MIT licence, written in JavaScript, 1 stars on GitHub and 1 open issue. The licence covers the code in the repository, not the hosted service at heartland-retail.usefulapi.io, which runs on its operator's own terms.