RacterMX

Install

Config snippet generator goes here (5 client tabs)

README

# @ractermx/mcp-server

MCP server for managing RacterMX email forwarding via AI assistants.

## Setup

```bash
npm install
```

## Configuration

Set environment variables:

- `RACTERMX_API_KEY` (required) — your `sk_*` API key from RacterMX
- `RACTERMX_API_URL` (optional) — defaults to `https://ractermx.com`

## Usage with Kiro / Claude Desktop

Add to your MCP config:

```json
{
  "mcpServers": {
    "ractermx": {
      "command": "node",
      "args": ["/path/to/ractermx-mcp/src/index.js"],
      "env": {
        "RACTERMX_API_KEY": "sk_your_key_here"
      }
    }
  }
}
```

## Available Tools (37 total)

All tools target the V2 API (`/api/v2`).

### Domains (8)
- `list_domains` — List all forwarding domains
- `get_domain` — Get domain details
- `add_domain` — Add a new domain
- `update_domain` — Update domain settings (active, catch-all, max aliases)
- `delete_domain` — Remove a domain
- `verify_domain_dns` — Trigger DNS verification
- `get_domain_dns_records` — Get required DNS records
- `get_domain_statistics` — Get email stats

### Aliases (5)
- `list_aliases` — List aliases for a domain
- `get_alias` — Get alias details
- `create_alias` — Create a new alias
- `update_alias` — Update an alias
- `delete_alias` — Delete an alias

### Email Logs (2)
- `list_email_logs` — Search email logs with filters
- `get_email_log` — Get a specific log entry

### Email Sending (1)
- `send_email` — Send an email

### Webhooks (7)
- `list_webhooks` — List webhook endpoints
- `create_webhook` — Create a webhook
- `update_webhook` — Update a webhook
- `delete_webhook` — Delete a webhook
- `test_webhook` — Send a test event
- `list_webhook_delivery_logs` — View delivery history
- `retry_webhook_delivery` — Retry a failed delivery

### Blocklist (3)
- `list_blocklist` — List blocked senders
- `add_blocklist_entry` — Block a sender/pattern
- `remove_blocklist_entry` — Unblock a sender

### API Keys (3)
- `list_api_keys` — List active keys
- `create_api_key` — Create a new key
- `revoke_api_key` — Revoke a key

### SMTP Credentials (4)
- `list_smtp_credentials` — List SMTP credentials for a domain
- `create_smtp_credential` — Create SMTP credentials
- `delete_smtp_credential` — Delete SMTP credentials
- `reset_smtp_password` — Reset SMTP credential password

### Retention Policy (2)
- `get_retention_policy` — View retention settings
- `update_retention_policy` — Update retention (metadata days, content days, per-event overrides)

### Anonymous Replies (2)
- `list_anonymous_replies` — List anonymous reply proxies
- `disable_anonymous_reply` — Disable a proxy address