Numeral MCP by usefulapi

usefulapi 的 Numeral MCP

在 Claude、Cursor 或任何 MCP 客户端中管理 Numeral 销售税合规事务 — 计算销售税和增值税、记录交易和退款，以及管理产品和客户。 托管服务，无需本地安装：使用你的 Numeral API 密钥连接。

在线端点： https://numeral.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、桌面版）：打开 自定义 → 连接器，点击 + 添加 → 添加自定义连接器，然后粘贴 https://numeral.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http numeral https://numeral.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "numeral": {
      "url": "https://numeral.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Numeral 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/numeral/

首次连接时，你需要粘贴 Numeral API 密钥（可在 Numeral 控制面板中获取）。密钥会经过验证、按用户存储，并仅限你本人使用 — 配置文件中不会包含密钥。

工具

工具	类型	功能
numeral_ping	读取	Ping（运行状况检查）
numeral_calculate_tax	读取	计算税费
numeral_get_transaction	读取	获取交易
numeral_list_transaction_refunds	读取	列出交易退款
numeral_list_products	读取	列出产品
numeral_get_product	读取	获取产品
numeral_get_customer	读取	获取客户
numeral_create_transaction	写入	创建交易
numeral_create_refund	写入	创建退款
numeral_create_product	写入	创建产品
numeral_create_customer	写入	创建客户
numeral_usage_status	元数据	使用情况（免费层额度计量）
numeral_request_feature	元数据	申请缺失的功能
numeral_upgrade	元数据	升级到 Pro（不限量*）
numeral_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先征求确认）；meta 工具用于报告使用情况、管理订阅或发送功能请求。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（每位用户）	$9/月 或 $90/年（免费 2 个月）	不限量*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 numeral_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 numeral_cancel_subscription 取消：Pro 将持续到已付费周期结束，当前周期不予退款；在此之前运行 numeral_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT — 参见 LICENSE。仅提供文档；服务由托管方提供。