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 分