io.usefulapi/heartland-retail

up checked 2026-11-11T17:37:45.805Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Heartland Retail MCP by usefulapi

Publisher-provided description

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

Summary by lookupd

Reads items, stock, customers, sales orders and gift cards from Heartland Retail, and creates or updates customer records.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add heartland-retail --url https://heartland-retail.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (16 tools)

Publisher-provided text

• 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
• 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/valu
• 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}.

Details

• Version: 1.1.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 865 ms
• First indexed: 2026-11-08T11:17:33.694Z
• Last seen in registry: 2026-11-11T00:17:27.292Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/heartland-retail/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/heartland-retail.svg)](https://lookupd.com/servers/io.usefulapi/heartland-retail)

• 62141 servers
• Last crawl: 2026-11-11T18:39:04.612Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp