Heartland Retail MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.0.0Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Read Heartland Retail items, stock, customers, sales orders and gift cards, and create or update customers, from an MCP client.

What you can do
  • Check the connected user and token with whoami.
  • Search and read items, locations and vendors, including cost, price and financial class.
  • Report stock quantities and values, optionally grouped by item or location.
  • Search and read customers, and create or update customer names and emails.
  • Search and read sales orders, order lines, invoices and POS tickets.
  • Look up a gift card's value and status by card number; check usage and manage the subscription.
When to use it
Useful when you work in Heartland Retail and want an assistant to answer stock, customer and sales questions or make small customer-record changes without opening the back office.
Requirements
Remote hosted endpoint connected by URL; no local install. Sign-in is via OAuth, and on first connect you supply your store subdomain and a Heartland Retail API token, which the server stores per user. No keys go in the client config.
Before you install
Create and update customer tools change store data, so confirm before running them. Your Heartland Retail API token is given to the hosted third-party service and stored per user. The free plan allows 50 calls a month; paid plans are billed through Stripe Checkout, and plan changes charge the price difference immediately with no refund on cancellation.

Installation

In SourceWeft

  1. Open Heartland Retail MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fheartland-retail/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Heartland Retail MCP by usefulapi

Use your Heartland Retail account from Claude, Cursor, or any MCP client. Read items, stock, customers, sales orders and POS tickets, and create or update customers. Hosted, no local install: connect with your own credentials.

Live endpoint: https://heartland-retail.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://heartland-retail.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http heartland-retail https://heartland-retail.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "heartland-retail": {      "url": "https://heartland-retail.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Heartland Retail credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/heartland-retail/

On first connect you provide a store subdomain (the part before .retail.heartland.us) and a Heartland Retail API token (my account → API → Generate new token). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
heartlandretail_whoamireadShow the connected user
heartlandretail_list_itemsreadList items
heartlandretail_get_itemreadGet item
heartlandretail_list_inventory_valuesreadList inventory values
heartlandretail_list_locationsreadList locations
heartlandretail_list_customersreadList customers
heartlandretail_get_customerreadGet customer
heartlandretail_create_customerwriteCreate customer
heartlandretail_update_customerwriteUpdate customer
heartlandretail_list_sales_ordersreadList sales orders
heartlandretail_get_sales_orderreadGet sales order
heartlandretail_list_sales_order_linesreadList sales order lines
heartlandretail_list_sales_invoicesreadList sales invoices
heartlandretail_list_sales_ticketsreadList POS tickets
heartlandretail_list_vendorsreadList vendors
heartlandretail_get_gift_cardreadGet gift card
heartlandretail_usage_statusmetaUsage status (free-tier meter)
heartlandretail_request_featuremetaRequest a missing feature
heartlandretail_upgrademetaUpgrade to Pro or Pro+
heartlandretail_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run heartlandretail_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with heartlandretail_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with heartlandretail_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/heartland-retail/README.md at commit 0be0869

Tools

16

heartlandretail_whoami

Show the connected user

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.

Takes no parameters.

heartlandretail_list_items

List items

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

Parameterspagequeryfilterper_page

heartlandretail_get_item

Get item

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

Parametersitem_idrequired

heartlandretail_list_inventory_values

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.

Parameterspagegroupitem_idper_page

heartlandretail_list_locations

List locations

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

Parameterspagequeryfilterper_page

heartlandretail_list_customers

List customers

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

Parameterspagequeryfilterper_page

heartlandretail_get_customer

Get customer

Get one customer by id: name, email, default address ids, custom fields and loyalty points. Heartland Retail: GET /api/customers/{customer_id}.

Parameterscustomer_idrequired

heartlandretail_create_customer

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.

Parametersemaillast_namefirst_name

heartlandretail_update_customer

Update customer

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

Parametersemaillast_namefirst_namecustomer_idrequired

heartlandretail_list_sales_orders

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.

Parameterspagequeryfilterper_page

heartlandretail_get_sales_order

Get sales order

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

Parametersorder_idrequired

heartlandretail_list_sales_order_lines

List sales order lines

List the lines (items, quantities, prices) of one sales order. Heartland Retail: GET /api/sales/orders/{order_id}/lines.

Parameterspageorder_idrequiredper_page

heartlandretail_list_sales_invoices

List sales invoices

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

Parameterspagequeryfilterper_page

heartlandretail_list_sales_tickets

List POS tickets

Search point-of-sale tickets (till sales) by text or JSON filter. Heartland Retail: GET /api/sales/tickets.

Parameterspagequeryfilterper_page

heartlandretail_list_vendors

List vendors

Search purchasing vendors (suppliers) by text or JSON filter. Heartland Retail: GET /api/purchasing/vendors.

Parameterspagequeryfilterper_page

heartlandretail_get_gift_card

Get gift card

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

Parametersgift_card_numberrequired

Version history

1
  1. v1.0.0LatestNov 8, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 8, 2026

Zomentum MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server that lets an assistant read Zomentum sales data — opportunities, pipelines, clients, documents, catalog items and activities — and create…

Streamable HTTPWeb executable
Productivity & Workflow25 toolsNov 8, 2026

Zero Plus One MCP by usefulapi

io.usefulapiOfficial publisher

Read-only access to Zero Plus One accounting data — invoices, quotes, contacts, financial reports and bank reconciliation — from an MCP client.

Streamable HTTPWeb executable
Finance24 toolsNov 8, 2026

Zenkit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted, read-only MCP access to Zenkit: browse workspaces, lists, fields, members and entries, and search entries by text.

Streamable HTTPWeb executable
Productivity & Workflow9 toolsNov 8, 2026

Zaui MCP by usefulapi

io.usefulapiOfficial publisher

Read-only access to a Zaui booking system: activities, availability, product stock, bookings and day manifests.

Streamable HTTPWeb executable
Productivity & Workflow9 toolsNov 8, 2026