How do I install Warp?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Warp need an API key?

The publisher lists these environment variables: WARP_API_TOKEN.

When was Warp last checked?

Last checked 2026-11-09. SIP trunking, numbers, porting, messaging, billing, and CDR analytics on the Ringer WARP platform

Warp MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

WARP_API_TOKEN — WARP API key (rk_...) — minted in the WARP portal at https://app.warp.ringer.tel under Settings → API Keys

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1WARP_API_TOKEN=<secret> claude mcp add io.github.ringer-warp -- npx -y warp-mcp@1.1.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.ringer-warp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "WARP_API_TOKEN": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.1.0
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

# Recommended: global install — the setup wizard runs automatically
npm install -g warp-mcp

# Or run the wizard explicitly / without installing
npx -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

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)

{
  "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:

claude mcp add --transport http warp https://mcp.warp.ringer.tel/ \
  --header "Authorization: Bearer $WARP_API_KEY"

{
  "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

Prefix	Group	Tools	What it does
`trunk_`	SIP Trunks	24	Trunk CRUD, SIP credentials, endpoints, IP ACLs, registrations
`port_`	Porting	33	Port-in requests end to end: draft → validate → submit → activate, documents, TIN compliance
`msg_`	Messaging	33	Send SMS, message history, 10DLC brands/campaigns, number enrollment, TCR reference data
`num_`	Numbers	15	Search, order, release DIDs; per-TN voice/SMS config; port-out PINs
`team_`	Team	9	Members and RBAC roles
`bill_`	Billing	5	Balance, ledger, invoices (JSON + HTML)
`cdr_`	Analytics	5	Call detail records, statistics, trends, CSV export
`acct_` / `net_` / `key_`	Account	10	Capacity, utilization, scopes, WARP network IPs, API-key audit
`warp_status`	Diagnostics	1	Config + 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

Variable	Default	Purpose
`WARP_API_TOKEN`	—	API key (`rk_...`). Overrides `~/.warp-mcp/config.json`
`WARP_API_BASE_URL`	`https://api.warp.ringer.tel`	API base URL override
`WARP_REQUEST_TIMEOUT_MS`	`30000`	Per-request timeout

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

Development

npm ci --ignore-scripts
npm 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.

Warp

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Warp?

Does Warp need an API key?

What transport does Warp use?

When was Warp last checked?

Documentation

warp-mcp

Quick Start

One-command installs

Hosted endpoint

Tools

Environment variables

Development

License