Heartland Retail MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.0.0更新於 Nov 8, 2026

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

發布方自己的服務：Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

透過 MCP 用戶端讀取 Heartland Retail 的商品、庫存、客戶、銷售訂單與禮品卡，並可建立或更新客戶。

可以做什麼
  • 用 whoami 確認目前連線的使用者與權杖是否有效。
  • 搜尋並讀取商品、門市據點與供應商，含成本、價格與財務分類。
  • 查看庫存數量與金額，可依商品或門市分組。
  • 搜尋並讀取客戶，並可建立客戶或修改其姓名與電子郵件。
  • 搜尋並讀取銷售訂單、訂單明細、發票與 POS 收據。
  • 依卡號查詢禮品卡餘額與狀態；查看用量並管理訂閱。
適用情境
適合使用 Heartland Retail 的商家，讓助理不必開啟後台就能回答庫存、客戶與銷售問題，或做少量客戶資料修改。
執行需求
遠端託管端點，以 URL 連線，無需本機安裝。透過 OAuth 登入，首次連線需提供門市子網域與 Heartland Retail API 權杖，伺服器依使用者儲存；用戶端設定中不填金鑰。
安裝前請注意
建立與更新客戶的工具會變更門市資料，執行前應先確認。Heartland Retail API 權杖會交給第三方託管服務並依使用者儲存。免費方案每月 50 次呼叫；付費方案經 Stripe Checkout 結帳，升級會立即補差額，取消當期不退費。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Heartland Retail MCP by usefulapi，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fheartland-retail/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源：servers/heartland-retail/README.md，提交 0be0869

工具

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.

無需輸入參數。

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.

輸入參數pagequeryfilterper_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}.

輸入參數item_id必填

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.

輸入參數pagegroupitem_idper_page

heartlandretail_list_locations

List locations

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

輸入參數pagequeryfilterper_page

heartlandretail_list_customers

List customers

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

輸入參數pagequeryfilterper_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}.

輸入參數customer_id必填

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.

輸入參數emaillast_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}.

輸入參數emaillast_namefirst_namecustomer_id必填

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.

輸入參數pagequeryfilterper_page

heartlandretail_get_sales_order

Get sales order

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

輸入參數order_id必填

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.

輸入參數pageorder_id必填per_page

heartlandretail_list_sales_invoices

List sales invoices

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

輸入參數pagequeryfilterper_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.

輸入參數pagequeryfilterper_page

heartlandretail_list_vendors

List vendors

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

輸入參數pagequeryfilterper_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}.

輸入參數gift_card_number必填

版本歷史

1
  1. v1.0.0最新Nov 8, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合

Ably MCP by usefulapi

io.usefulapi官方發布者

面向 Ably 即時訊息的託管 MCP 伺服器：檢視頻道歷史、線上狀態與佔用情形，發布訊息，並查看應用程式用量與設定。

Streamable HTTP可網頁執行
雲端與基礎設施15 個工具Nov 8, 2026

Zomentum MCP by usefulapi

io.usefulapi官方發布者

託管式 MCP 伺服器，讓助理讀取 Zomentum 銷售資料（商機、銷售流程、客戶、文件、商品目錄與活動），並可建立任務或新增留言。

Streamable HTTP可網頁執行
效率與工作流25 個工具Nov 8, 2026

Zero Plus One MCP by usefulapi

io.usefulapi官方發布者

以唯讀方式存取 Zero Plus One 會計資料——發票、報價、聯絡人、財務報表與銀行對帳——供 MCP 用戶端使用。

Streamable HTTP可網頁執行
金融24 個工具Nov 8, 2026

Zenkit MCP by usefulapi

io.usefulapi官方發布者

託管的 Zenkit 唯讀 MCP 服務：瀏覽工作區、清單、欄位、成員與項目，並依文字搜尋項目。

Streamable HTTP可網頁執行
效率與工作流9 個工具Nov 8, 2026

Zaui MCP by usefulapi

io.usefulapi官方發布者

以唯讀方式存取 Zaui 預訂系統：活動、可預訂狀況、商品庫存、預訂與當日名單。

Streamable HTTP可網頁執行
效率與工作流9 個工具Nov 8, 2026