Tillhub MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.7.4更新于 Nov 7, 2026

Read Tillhub products, stock, transactions, customers and retail reports from your AI assistant.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行金融数据与分析商业与电商

概览

AI 生成的概览

远程 MCP 服务器,让助手读取 Tillhub 零售数据:商品、库存、交易、客户与销售报表。

可以做什么
  • 查询商品、商品分组、标签、税率、折扣与支付方式
  • 读取库存数量、库存地点、库存流水与订单
  • 列出并查看交易、小票与收银机日结
  • 查询营收总额、按小时或按天的销售、热销商品与交易报表
  • 列出客户、门店、收银机与员工,并查看登录账号信息
  • 查看用量、提交功能请求、升级或取消订阅
适用场景
适合使用 Tillhub 经营门店、希望用自然语言询问销售、热销商品、库存水平或客户记录而无需打开后台的人。适合店主与管理者查看数据,也适合对周期性报表做轻量自动化。
运行要求
远程 MCP 端点,仅需添加 URL,无需安装包或本地运行时。通过 OAuth 使用 Tillhub 账号登录,客户端配置中不需要 API 密钥或 Authorization 头。免费方案每月 50 次工具调用,付费方案可提高上限。
安装前请注意
这是第三方付费代理服务:免费额度每月仅 50 次调用,Pro(每月 9 美元)或 Pro+(每月 39 美元)通过工具返回的 Stripe 结账链接付费。订阅类工具可开通或取消计费。Tillhub 登录凭据需在服务商的 OAuth 页面输入,包含客户联系方式的零售数据会经由该服务商读取。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Tillhub MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Ftillhub/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Tillhub MCP by usefulapi

Read retail records at https://tillhub.usefulapi.io/mcp.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://tillhub.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http tillhub https://tillhub.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": {    "tillhub": {      "url": "https://tillhub.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 Tillhub credentials.

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

Tools

ToolTypeWhat it does
tillhub_get_accountreadGet API user and account
tillhub_list_productsreadList products
tillhub_search_productsreadSearch products
tillhub_get_productreadGet product
tillhub_list_product_groupsreadList product groups
tillhub_list_tagsreadList tags
tillhub_list_transactionsreadList transactions
tillhub_get_transactionreadGet transaction
tillhub_transactions_reportreadTransactions report
tillhub_list_receiptsreadList receipts
tillhub_revenue_sumreadRevenue total for a period
tillhub_sales_aggregatereadSales per hour or day
tillhub_top_productsreadTop products
tillhub_list_balancesreadList cash-register balances
tillhub_list_customersreadList customers
tillhub_search_customersreadSearch customers
tillhub_get_customerreadGet customer
tillhub_list_branchesreadList branches
tillhub_list_registersreadList registers
tillhub_list_staffreadList staff
tillhub_list_payment_optionsreadList payment options
tillhub_list_taxesreadList taxes
tillhub_list_discountsreadList discounts
tillhub_list_stockreadList stock levels
tillhub_list_stock_locationsreadList stock locations
tillhub_list_stock_bookreadList stock movements
tillhub_list_ordersreadList orders
tillhub_usage_statusmetaUsage status (free-tier meter)
tillhub_request_featuremetaRequest a missing feature
tillhub_upgrademetaUpgrade to Pro or Pro+
tillhub_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 Tillhub account)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with tillhub_upgrade (it returns a Stripe Checkout link). Cancel any time with tillhub_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running tillhub_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

来源:servers/tillhub/README.md,提交 4046075

工具

27

tillhub_get_account

Get API user and account

The Tillhub user behind the API key: role, scopes, account id and name (no credentials). GET /api/v0/me.

无需输入参数。

tillhub_list_products

List products

List products (articles, variants, vouchers) with name, number, barcode, prices, taxes and product group. Filter by type, group, tag, barcode or custom id (barcode and custom_id are fast exact lookups and ignore the other filters). Page with next_query. GET /api/v1/products/{account}.

输入参数tagtypelimitactivebarcodedeletedsellablecustom_idnext_queryproduct_groupupdated_since

tillhub_search_products

Search products

Fuzzy search products by name and description (max 20 hits per page, with relevance score). GET /api/v2/products/{account}/search.

输入参数limitquery必填offsetsellable

tillhub_get_product

Get product

One product by id, optionally with the stock and prices of one branch. GET /api/v1/products/{account}/{id}.

输入参数branchproduct_id必填

tillhub_list_product_groups

List product groups

List product groups (categories) with id and name. GET /api/v0/product_groups/{account}.

输入参数activedeletednext_query

tillhub_list_tags

List tags

List product tags. GET /api/v1/tags/{account}.

输入参数querydeletednext_query

tillhub_list_transactions

List transactions

List sales and other register transactions (type, date, branch, register, staff, customer, amounts, payments, cart items). Always pass a date range for busy shops. Page with next_query. GET /api/v1/transactions/{account}.

输入参数typelimitstaffbranchcustomerdate_endregisterdate_startnext_queryreceipt_number

tillhub_get_transaction

Get transaction

One transaction by id with its full cart, payments and taxes. GET /api/v1/transactions/{account}/{id}.

输入参数transaction_id必填

tillhub_transactions_report

Transactions report

Detailed transactions report for a period, filterable by branch, register, staff, customer, type and currency. GET /api/v3/analytics/{account}/reports/transactions/overview.

输入参数typestaffbranchcurrencycustomerdate_endregisterdate_startnext_query

tillhub_list_receipts

List receipts

List receipts (printed or digital) of the account. Page with next_query. GET /api/v1/receipts/{account}.

输入参数limitnext_query

tillhub_revenue_sum

Revenue total for a period

Total revenue between two points in time, optionally for one branch number. GET /api/v0/analytics/{account}/aggregates/revenues/sum.

输入参数end必填start必填next_querybranch_number

tillhub_sales_aggregate

Sales per hour or day

Sales and revenue aggregated per hour or per day between two points in time. GET /api/v0/analytics/{account}/aggregates/sales.

输入参数end必填start必填precisionnext_querybranch_number

tillhub_top_products

Top products

Best-selling products in a period, optionally for one branch number. GET /api/v0/analytics/{account}/reports/products/top.

输入参数endstartnext_querybranch_number

tillhub_list_balances

List cash-register balances

List cash-register closings (balances / Z-reports) with totals per register and day. Filter by branch, register or staff. Page with next_query. GET /api/v0/analytics/{account}/reports/balances.

输入参数limitquerystaffbranchregisternext_query

tillhub_list_customers

List customers

List customers with name, company, email, phone numbers and addresses. Filter by text, name, email, company or customer number. Page with next_query. GET /api/v1/customers/{account}.

输入参数emaillimitqueryactivecompanylastnamefirstnamenext_queryupdated_sincecustomer_number

tillhub_search_customers

Search customers

Fuzzy search customers by name, email and description (max 100 hits, with relevance score). GET /api/v2/customers/{account}/search.

输入参数limitquery必填offset

tillhub_get_customer

Get customer

One customer by id. GET /api/v1/customers/{account}/{id}.

输入参数customer_id必填

tillhub_list_branches

List branches

List branches (shops) with number, name and address. Use the ids to filter transactions, stock and prices. Page with next_query. GET /api/v1/branches/{account}.

输入参数namelimitqueryactivenext_query

tillhub_list_registers

List registers

List cash registers with number, name and branch. GET /api/v1/registers/{account}.

输入参数queryactivebranchnext_query

tillhub_list_staff

List staff

List staff members (cashiers) with name, number and branch. PINs and passwords are never returned. GET /api/v1/staff/{account}.

输入参数queryactivebranchnext_query

tillhub_list_payment_options

List payment options

List payment options (cash, card, voucher, ...) configured for the account. GET /api/v0/payment_options/{account}.

输入参数activenext_query

tillhub_list_taxes

List taxes

List tax (VAT) references with rates. GET /api/v0/taxes/{account}.

输入参数activenext_query

tillhub_list_discounts

List discounts

List configured discounts. GET /api/v0/discounts/{account}.

输入参数activebranchnext_query

tillhub_list_stock

List stock levels

Current stock per product and location. Filter by location (branch/warehouse id) or product id. GET /api/v0/stock/{account}.

输入参数productlocationnext_query

tillhub_list_stock_locations

List stock locations

List stock locations (branches and warehouses) with their ids. GET /api/v0/stock/{account}/locations.

输入参数next_query

tillhub_list_stock_book

List stock movements

Stock book: every stock movement (sale, delivery, correction, transfer) with product, location, quantity and date. Filter by product, location, period or text. Page with next_query. GET /api/v1/stock/{account}/book.

输入参数endlimitquerystartproductlocationnext_query

tillhub_list_orders

List orders

List incoming or outgoing orders (goods orders between locations/suppliers). Page with next_query. GET /api/v0/orders/{account}.

输入参数limitdeleteddirectionnext_query

版本历史

10
  1. v1.7.4最新Nov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.2Oct 30, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成