Warp

io.github.Ringer由 GitHub 账号 Ringer 发布v1.1.0更新于 Oct 24, 2026

SIP trunking, numbers, porting, messaging, billing, and CDR analytics on the Ringer WARP platform

已验证STDIO仅桌面沟通与协作数据与分析商业与电商

概览

AI 生成的概览

让助手管理 Ringer WARP 电信服务：SIP 中继、电话号码、携号转网、短信/10DLC、账单和通话详单分析。

可以做什么
将 WARP 客户 API 封装为约 135 个工具，按前缀分组：trunk_ 用于 SIP 中继的增删改查、凭据、端点、IP 访问控制和注册；port_ 覆盖携号转入从草稿、校验、提交到激活的全流程及文件和 TIN 合规；msg_ 用于发送短信、消息历史和 10DLC 品牌/活动注册；num_ 用于搜索、订购和释放 DID 以及转出 PIN；team_ 管理成员和 RBAC 角色；bill_ 查看余额、账本和发票；cdr_ 提供通话详单、统计、趋势和 CSV 导出；acct_/net_/key_ 涉及容量、权限范围、网络 IP 和 API 密钥审计；另有 warp_status 诊断。还附带 warp-guide 提示词。
适用场景
当助手需要操作或查看 Ringer WARP 电信账户时使用：配置或修改 SIP 中继、购买或释放号码、推进携号转入流程、注册 10DLC 品牌和活动、发送短信，或查看发票与通话详单分析。
运行要求
本地运行 npm 包 warp-mcp 需要 Node.js 运行时（stdio），也可改用托管的 Streamable HTTP 端点。认证需要 WARP API 密钥（rk_...），通过 WARP_API_TOKEN 提供；托管端点则使用 OAuth 2.1 登录。可选覆盖项：WARP_API_BASE_URL 和 WARP_REQUEST_TIMEOUT_MS。需要访问 WARP API 的网络。仅支持桌面客户端。
安装前请注意
WARP_API_TOKEN 是授予账户级访问权限的密钥，安装向导会将其保存到 ~/.warp-mcp/config.json。许多工具会写入或更改真实电信资源——中继和端点配置、号码订购与释放、携号转入提交、短信发送、10DLC 注册——部分操作可能产生费用或影响服务。托管端点不包含管理界面、Buzz 和 API 密钥管理。让助手执行前请先确认操作内容。

安装

在 SourceWeft 中

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

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

warp-mcp

MCP server for the Ringer WARP platform — SIP trunking, phone numbers, porting, messaging/10DLC, billing, and CDR analytics.

Gives AI agents (Claude, Cursor, Copilot, Codex, ChatGPT) full access to the WARP Customer API: 135 tools covering trunk provisioning, number search and ordering, port-in lifecycle, 10DLC brand/campaign registration, SMS sending, invoices, and call-detail analytics.

Quick Start

bash
# Recommended: global install — the setup wizard runs automaticallynpm install -g warp-mcp
# Or run the wizard explicitly / without installingnpx -y warp-mcp setup

The wizard validates your API key, stores it in ~/.warp-mcp/config.json, and registers the server with every MCP client it detects (Claude Code, Claude Desktop, Cursor, Codex, GitHub Copilot, ChatGPT Desktop).

You need a WARP API key (rk_...) — mint one in the WARP portal under Settings → API Keys.

One-command installs

Claude Code

bash
claude mcp add -s user warp -e WARP_API_TOKEN=rk_your_key -- npx -y warp-mcp

Cursor — click to install (then replace YOUR_WARP_API_KEY)

Manual (any MCP client)

json
{  "mcpServers": {    "warp": {      "command": "npx",      "args": ["-y", "warp-mcp"],      "env": { "WARP_API_TOKEN": "rk_your_key" }    }  }}

See INSTALL.md for per-client walkthroughs, troubleshooting, and uninstall steps.

Hosted endpoint

No local install needed — connect straight to https://mcp.warp.ringer.tel/ (Streamable HTTP).

Desktop connectors (claude.ai, ChatGPT): add a custom connector with that URL and sign in with your WARP account when prompted — the hosted endpoint authenticates via OAuth 2.1 and grants your customer-scoped permissions (excluding admin surfaces, Buzz, and API-key management — those stay in the portal).

Developer / CLI clients: authenticate with a bearer rk_ key instead:

bash
claude mcp add --transport http warp https://mcp.warp.ringer.tel/ \  --header "Authorization: Bearer $WARP_API_KEY"
json
{  "mcpServers": {    "warp": {      "type": "http",      "url": "https://mcp.warp.ringer.tel/",      "headers": { "Authorization": "Bearer rk_your_key_here" }    }  }}

Keys are minted in the WARP portal under Settings → API Keys.

Tools

PrefixGroupToolsWhat it does
trunk_SIP Trunks24Trunk CRUD, SIP credentials, endpoints, IP ACLs, registrations
port_Porting33Port-in requests end to end: draft → validate → submit → activate, documents, TIN compliance
msg_Messaging33Send SMS, message history, 10DLC brands/campaigns, number enrollment, TCR reference data
num_Numbers15Search, order, release DIDs; per-TN voice/SMS config; port-out PINs
team_Team9Members and RBAC roles
bill_Billing5Balance, ledger, invoices (JSON + HTML)
cdr_Analytics5Call detail records, statistics, trends, CSV export
acct_ / net_ / key_Account10Capacity, utilization, scopes, WARP network IPs, API-key audit
warp_statusDiagnostics1Config + connectivity check

The server also ships a warp-guide prompt (and server instructions) with deep WARP domain knowledge — workflows, concepts, and common mistakes.

Environment variables

VariableDefaultPurpose
WARP_API_TOKEN—API key (rk_...). Overrides ~/.warp-mcp/config.json
WARP_API_BASE_URLhttps://api.warp.ringer.telAPI base URL override
WARP_REQUEST_TIMEOUT_MS30000Per-request timeout

Token resolution order: env var → ~/.warp-mcp/config.json → unauthenticated (tools return guidance to run setup).

Development

bash
npm ci --ignore-scriptsnpm run build   # tsc → dist/npm test        # vitest (in-memory MCP transport)npm run dev     # tsx src/index.ts

Releases are published from CI: npm version patch|minor|major, push with --follow-tags, create a GitHub release — the workflow publishes to npm (OIDC trusted publishing with provenance) and to the MCP Registry (io.github.ringer/warp). Do not run npm publish locally after the initial release.

License

MIT © Ringer

来源：README.md，提交 0053959

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分