CLI

The whole API, from your terminal

A command for every resource, events forwarded to localhost, audio piped into calls, agent skills and a local MCP server.

Start building Read the CLI guide

polymorfa --help

~/acme $ polymorfa --help

Usage: polymorfa <command> [options]

Commands:

messageSend, edit, react to and delete messages

mediaUpload and download media

groupCreate groups and manage members

channelCreate, follow and mute channels

contactCheck, block and look up contacts

labelManage labels and chat assignments

quick-replyManage quick replies

quicklinkCreate links that connect a number

customerManage Customers and pairing links

campaignCreate, launch and track campaigns

callPlace, answer and control calls

sip-trunkRoute calls to your phone system

businessBusiness profile, catalog and orders

bansafeHealth, Safe Mode and warm-up

eventInspect, replay and stream events

webhookConfigure and test webhooks

sessionList, restart and stop numbers

keyManage API keys

Local development

Build and test without a tunnel.

Forward events to localhost, pipe audio into a call and search the docs from the shell.

Events on localhost. polymorfa listen streams your project's events to a local handler and signs each one with a per-run secret.

Verify them with the SDKs

Calls from the shell. polymorfa calls media places or answers a WhatsApp call and pipes raw audio in and out, so a recording plays and the reply lands in a file.

Explore Calls

Docs without leaving the shell. polymorfa docs search finds pages by title and path, and docs open goes straight to one.

For agents

Your agent drives the CLI too.

Load the bundled skills and add the CLI's own MCP server, without touching the hosted one.

Explore the hosted MCP

Two skills in the package. polymorfa sets up profiles, projects, JSON output and safe changes. polymorfa-webhooks covers events, replay, retries and local listening.

A local MCP server. polymorfa mcp install adds a stdio server to Codex or Claude that lists sessions and runs listeners. It never returns phone numbers, credentials or message data.

Set up

From install to first event.

Four commands cover a setup check, any API call, local events and your agent.

terminal

Install$npm install -g @polymorfa/cli@0.1.0-dev.0

polymorfa auth login            # stores your key in the system keyring
polymorfa link --project my-app  # this folder now uses my-app
polymorfa doctor

API surface

Commands worth knowing.

A few favorites. Every command uses your profile or key, and the API still enforces its scopes.

CLI docs

Start

$polymorfa initWrite a Node.js and TypeScript starter in this folder
$polymorfa link --project my-appBind a folder to a project, safe to commit
$polymorfa completion zshTab completion for bash, zsh and fish
$polymorfa docs open api/rate-limitsOpen any docs page from the shell

Test

$polymorfa trigger message.receivedFire a signed test event at a Test number
$polymorfa listenForward events to your local handler
$polymorfa webhook test <id>Send a test delivery to a webhook
$polymorfa event replay <id>Deliver a past event again

Run

$polymorfa calls media --place <number>Pipe raw audio into and out of a WhatsApp call
$polymorfa calls watch --jsonStream call updates for a number
$polymorfa operation watch <id>Print each status change of a campaign or job
$polymorfa api <path> --paginateCall any endpoint and follow every page

Agents

$polymorfa mcp install claudeAdd the local MCP server to Claude or Codex
$polymorfa mcp toolsList the local MCP tools

Start with a free number

Your first real number is free. Add more numbers on Pay-As-You-Go.

Start building See pricing