MCP HeartbeatTHE MCP OBSERVATORY
Public workspace

Explore

Evidence for your next connection.

Independent measurements of remote MCP servers. Every observation has a timestamp.

Read-only probes

MCP server · Payments & trading

Heartland Retail MCP by usefulapi

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

Checks passed
13 / 22

1 failed · 8 not measured

Median response
196 ms

Median of successful probes over 7 days

30-day uptime
Not measured

Share of countable probes over 30 days, including daily rollups. Auth challenges are excluded.

Discovered tools
16

Tool definitions returned by this server

Independent monitoring

Health & checks

Status history

Outdated check

Last connection measurement is over 24 hours old. Current availability is unknown.

Last checked
Check summary by test group
Test areaPassedFailedUnmeasured
ConnectionCan a client connect and discover tools?
500
Reliability & speedDoes it respond consistently and quickly?
004
Access & authenticationWhat is required to use this server?
102
Tool qualityAre the tool definitions usable by an agent?
310
Publisher identityCan the publisher be traced to its source?
402

Unmeasured means there is not enough evidence to decide. How these checks work

Inspect individual checks 22 recorded

Core

  • Pass
    Reachable

    Latest probe returned HTTP 200 in 196 ms.

  • Pass
    Valid handshake

    protocolVersion 2025-11-25, serverInfo.name heartland-retail-mcp.

  • Pass
    Lists tools

    tools/list returned 16 tools.

  • Pass
    Current protocol

    Negotiated 2025-11-25. The bar is 2025-06-18 or newer.

  • Pass
    HTTPS

    The endpoint URL is https.

Performance

  • Not measured
    Fast (p50)

    Median latency 196 ms over 1 samples in 7 days. The bar is 1000 ms. Need at least 5 samples.

  • Not measured
    Consistent (p95)

    95th percentile 196 ms over 1 samples in 7 days. The bar is 3000 ms. Need at least 20 samples.

  • Not measured
    Reliable (uptime)

    1 of 1 attempts returned a tool list in 30 days (100%). The bar is 99%. Need at least 30 samples.

  • Not measured
    Stable tool list

    Fewer than two successful probes in 30 days, so tool-list stability is not measured.

Access

  • Pass
    Open access

    tools/list succeeded with no credential, and the record declares none.

  • Not measured
    Standard auth

    Auth is not required, so the OAuth metadata check does not apply.

  • Not measured
    Free tier cited

    No publisher quote has been checked.

Tools

  • Pass
    Tools described

    Every tool description is at least 20 characters.

  • Pass
    Valid input schemas

    Every inputSchema is a JSON Schema object.

  • Pass
    Parameters documented

    40 of 46 parameters have a description (87%). The bar is 80%.

  • Fail
    Safety hints

    1 tools set neither readOnlyHint nor destructiveHint.

Publisher

  • Pass
    Verified namespace

    Listed in the Official MCP Registry.

  • Pass
    Website matches publisher

    The website host matches the reverse-domain namespace.

  • Pass
    Source repo linked

    A repository URL is on file.

  • Not measured
    Repo owner matches

    This namespace is not an io.github login, so the owner comparison does not apply.

  • Pass
    Recently updated

    Updated 2026-11-10T23:35:22.508513Z, within 180 days.

  • Not measured
    Open-source licence

    The GitHub licence lookup has not returned an OSI result yet.

Start using Heartland Retail MCP by usefulapi

Connect to this server

Choose your client, copy the configuration, then enable the server in your client’s MCP settings.

Run this command in your terminal, then restart Claude Code.

Claude Code

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

Capabilities

Tools 16

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.

Discovered
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}.

Discovered
heartlandretail_get_gift_card

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

Discovered
heartlandretail_get_item

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

Discovered
heartlandretail_get_sales_order

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

Discovered
heartlandretail_list_customers

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

Discovered
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.

Discovered
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.

Discovered
heartlandretail_list_locations

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

Discovered
heartlandretail_list_sales_invoices

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

Discovered
heartlandretail_list_sales_order_lines

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

Discovered
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.

Discovered
heartlandretail_list_sales_tickets

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

Discovered
heartlandretail_list_vendors

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

Discovered
heartlandretail_update_customer

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

Discovered
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.

Discovered

Recent measurements

Probe history

View status
Latest stored probes. Raw probe rows are kept for 14 days.
CheckedResultResponseTools
Connected196 ms16