numberbroom-mcp

Name: numberbroom-mcp
Author: cameron-creations

远程服务

numberbroom.com商业与营销06 天前更新

关于 numberbroom-mcp

numberbroom-mcp 是一个远程 MCP 服务，通过 NumberBroom API 验证美国电话号码并提交批量清理任务。它面向需要查询运营商、线路活跃度或已知诉讼人信息的 Agent，并提供账户余额和批次任务工具。

通过 NumberBroom API 提供单号码验证、账户额度和批量清理的 MCP 工具。客户端可通过 OAuth 登录或 API 密钥请求头连接远程服务。

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://numberbroom.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http cameron-creations-numberbroom https://numberbroom.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"cameron-creations-numberbroom":{"type":"http","url":"https://numberbroom.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"cameron-creations-numberbroom":{"type":"http","url":"https://numberbroom.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"cameron-creations-numberbroom":{"type":"http","url":"https://numberbroom.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"cameron-creations-numberbroom":{"serverUrl":"https://numberbroom.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://numberbroom.com/mcp需要授权

一个远程 MCP 服务，让 AI Agent 通过 NumberBroom API 验证美国电话号码：运营商级别的线路类型、运营商名称、带有可能已停用标记的活跃度评分，以及已知诉讼人状态。Agent 还可以向用户提供添加余额或为整份号码列表付费清理的链接。

每次工具调用都会转为对 https://numberbroom.com/api/v1 的调用，由该 API 负责速率限制、计费、退款和滥用防护。此服务封装的 REST API 详见 numberbroom.com/developers。

工具	说明	费用
`verify_phone_number`	查询一个美国号码的线路类型、运营商、活跃度评分和已知诉讼人标记。该标记涵盖法院文件中与 TCPA、FDCPA、FCRA 和 CFPB 诉讼相关的号码；标记不会说明涉及哪部法律，而且没有任何数据库能收录所有诉讼人。	每次调用从 NumberBroom 余额扣除 $0.20，或在账户通过 AWS Marketplace 关联时计入 AWS 账单。无法解析的号码和非美国号码不会收费。
`get_credit_balance`	查看 NumberBroom 账户的预付余额，或确认查询费用是否通过 AWS Marketplace 计费。	免费。
`buy_credits`	提供 Stripe Checkout 链接，用于为账户添加余额。	调用免费；由用户通过 Stripe 付款。
`scrub_list`	提交整份号码列表（最多 10,000 个）进行 NumberBroom 付费列表清理，并返回价格和 Stripe Checkout 链接。	调用免费；用户按列表刷卡付款。
`get_list_status`	查看列表清理的状态和数量；完成后提供有效期为一小时的下载链接，包括清理后的文件、附带移除原因的已删除行（会统计但不会列出命中「请勿致电登记册」的号码）、仅包含已知诉讼人的文件，以及包含非美国号码的行（这些号码不会被清理或收费）。	免费。

服务 URL 为 https://numberbroom.com/mcp。有两种连接方式：

登录（OAuth）。 通过登录连接的客户端会从服务的 401 质询中发现授权服务器。你可以登录或创建 NumberBroom 账户；如果账户没有余额，则添加余额，然后批准授权。客户端会获得一个令牌；其背后的 API 密钥仅保留在连接中，你可以随时在 NumberBroom 的 Settings 中断开连接。客户端注册仅支持 Client ID Metadata Document。
API 密钥请求头。 使用请求头的客户端可以使用 numberbroom.com/settings 中的密钥：
```
Authorization: Bearer nb_live_YOUR_KEY
```

每个客户端的逐步设置说明见 numberbroom.com/mcp-server。在浏览器中打开 https://numberbroom.com/mcp 会重定向到该页面；MCP 客户端不受影响。

npm install
npm run dev

此命令通过 wrangler dev 在 http://localhost:8787/mcp 启动服务。OAuth 流程需要 OAUTH_KV 绑定（在 wrangler dev 下本地运行）和 MCP_INTERNAL_SECRET 密钥。

npm run deploy

将服务部署到 Cloudflare Workers，名称为 numberbroom-mcp。需要通过 wrangler login 登录 Cloudflare 账户。

OAuth 使用 @cloudflare/workers-oauth-provider。NumberBroom 自有的登录流程（numberbroom.com/connect）负责身份验证。你批准后，NumberBroom API 会通过服务器到服务器的方式，为此 Worker 提供你账户的密钥；Worker 仅将其保存在 KV 中的加密授权记录内。令牌和代码均以哈希形式存储。
限制和计费由 NumberBroom API 统一执行一次：每个密钥每天最多查询 5,000 次；通过此服务发起的调用最多为 500 次，除非密钥自身设有更低限额；此外还包括断路器和失败查询退款。
上游错误页面或网络故障会以普通工具错误的形式返回给 Agent，绝不会抛出异常。
每个请求都会创建一个独立的 MCP 服务实例；调用方之间不会共享状态。