# Install tools

> Developer tools for the 23 Telecom SMS API — MCP server for AI agents (Claude, Cursor), the 23telecom CLI, Postman collection and OpenAPI spec.
> Source: https://docs.23telecom.co.uk/tools/install-tools/

Instructions for LLMs: This is one page of the 23 Telecom messaging API docs
(SMS today; more channels planned). Base URL: https://restlink23telecom.com/api/v1,
auth via the X-API-Key header. Match errors on the error_code field, never on
description text. Full docs: https://docs.23telecom.co.uk/llms-full.txt · Schemas: https://docs.23telecom.co.uk/openapi.yaml

## 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`.

  
    ```bash
    claude mcp add 23telecom -e TELECOM23_API_KEY=sk_test_your_key -- npx -y @23telecom/mcp
    ```
  
  
    ```json
    {
      "mcpServers": {
        "23telecom": {
          "command": "npx",
          "args": ["-y", "@23telecom/mcp"],
          "env": { "TELECOM23_API_KEY": "sk_test_your_key" }
        }
      }
    }
    ```
  

  Start agents on a [sandbox key](/sandbox) (`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](/api-keys).

## 23telecom CLI

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

```bash
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](/tools/postman) — import, set two variables, send.
- [OpenAPI 3.1 spec](/tools/openapi) — generate clients, mocks and
  contract tests.

## SDKs

Official libraries for TypeScript, Python and PHP — see
[Libraries & SDKs](/sdks).