Install tools

MCP server — let AI agents send SMS

The @23telecom/mcp server gives Claude, Cursor or any MCP client five tools: send_sms, get_message_status, get_balance, get_stats, list_messages.

Claude Code

claude mcp add 23telecom -e TELECOM23_API_KEY=sk_test_your_key -- npx -y @23telecom/mcp

Claude Desktop / Cursor

{
  "mcpServers": {
    "23telecom": {
      "command": "npx",
      "args": ["-y", "@23telecom/mcp"],
      "env": { "TELECOM23_API_KEY": "sk_test_your_key" }
    }
  }
}

Give agents a sandbox key

Start agents on a sandbox key (sk_test_…) — simulated and free; the send_sms tool tells the agent which mode is active. For live keys, grant the minimum permissions (e.g. sms.send only) — see API keys.

23telecom CLI

Single static binary, Go stdlib only — send and inspect SMS from any shell:

cd cli && go build -o 23telecom .

export TELECOM23_API_KEY=sk_test_...
23telecom send --to +447911123456 --message "Hello!" --sender MyApp
23telecom status <message_id>
23telecom balance
23telecom stats --period 30d
23telecom messages --status delivered --limit 10

Every command takes --json for raw output (pipe to jq). Exit codes: 0 ok · 1 API error · 2 usage error.

Postman & OpenAPI

• Postman collection — import, set two variables, send.
• OpenAPI 3.1 spec — generate clients, mocks and contract tests.

SDKs

Official libraries for TypeScript, Python and PHP — see Libraries & SDKs.