# SmsManager MCP Server

MCP (Model Context Protocol) server for sending SMS messages via [SmsManager.cz](https://smsmanager.cz) HTTP API. Built for use with Claude Code.

## Tools

| Tool | Description |
|------|-------------|
| `send_sms` | Send an SMS to a phone number via SmsManager.cz |

### send_sms parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `phone_number` | Yes | Recipient number with country code, no `+` (e.g. `420777123456`) |
| `message` | Yes | SMS text, max 1000 characters |
| `gateway` | No | Delivery quality: `high` (default), `economy`, `low` |

## Setup

### 1. Install dependencies

```bash
cd smsmanager-mcp
npm install
```

### 2. Get API key

Get your API key from [SmsManager admin panel](https://app.smsmanager.com).

### 3. Add to Claude Code

Add to your project's `.mcp.json`:

```json
{
  "mcpServers": {
    "smsmanager": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/smsmanager-mcp/index.js"],
      "env": {
        "SMSMANAGER_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

Or via CLI:

```bash
claude mcp add smsmanager -e SMSMANAGER_API_KEY=your_key -- node /absolute/path/to/smsmanager-mcp/index.js
```

## Usage

Once configured, Claude can send SMS:

> "Send an SMS to 420777123456 saying 'Meeting at 3pm tomorrow'"

## API

Uses the SmsManager.cz HTTP API (`https://http-api.smsmanager.cz/Send`).

[Full API documentation](https://smsmanager.cz/docs/)

## Phone number format

Include country code without `+`: `420777123456` (Czech Republic = 420).

## License

MIT