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