# SendLetter MCP server

> Sends real, printed letters by post across Europe using text, rich text, or PDF files.

- Repository: https://github.com/gertsnijder/sendletter-node
- Page: https://hostedmcp.org/servers/gertsnijder/sendletter-node
- Transport: remote
- Stars: 0
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http sendletter-node https://sendletter.eu/api/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "sendletter-node": {
      "url": "https://sendletter.eu/api/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "sendletter-node": {
      "type": "http",
      "url": "https://sendletter.eu/api/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"sendletter-node","type":"http","url":"https://sendletter.eu/api/mcp"}'
```

### Codex

```sh
codex mcp add sendletter-node --url https://sendletter.eu/api/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.sendletter-node]
url = "https://sendletter.eu/api/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http sendletter-node https://sendletter.eu/api/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "sendletter-node": {
      "url": "https://sendletter.eu/api/mcp",
      "type": "http"
    }
  }
}
```

## FAQ

### How can I test the service without being charged?

You can use a test key starting with `sk_test_` which runs the full status chain without charging your account or printing anything.

### What formats can I use to send content?

You can provide content as plain text, rich text (document), a base64 encoded file, or a file URL.

### Can I verify if an address is correct before sending?

Yes, the service provides a validation method that returns address problems instead of throwing an error.

### How do I prevent duplicate letters if a network request fails?

Use an idempotency key on retriable requests; a repeat with the same key will return the original letter instead of creating a new one.
