ranla-mcp

MCP server for Ranla — the Ranla agent tools plus transactional mail tools, for Cursor, Claude Code, and other MCP clients (stdio or --http).

Hosted (no install)

Connect to the hosted server and sign in with OAuth when your client asks. No API key:

{
  "mcpServers": {
    "ranla": {
      "url": "https://mcp.ranla.ai/mcp"
    }
  }
}

Claude Code: claude mcp add --transport http ranla https://mcp.ranla.ai/mcp, then run /mcp to sign in.

Local (stdio)

export RANLA_API_KEY=rnl_your_key_here
npx -y ranla-mcp@latest
# optional overrides:
# export RANLA_API_URL=https://api.ranla.ai
# export RANLA_APP_URL=https://app.ranla.ai

Cursor .cursor/mcp.json:

{
  "mcpServers": {
    "ranla": {
      "command": "npx",
      "args": ["-y", "ranla-mcp@latest"],
      "env": {
        "RANLA_API_KEY": "rnl_your_key_here"
      }
    }
  }
}

Keep @latest in the args: without it npx reuses whatever version it downloaded first. When the local server is out of date it logs one line to stderr and tells your agent once (in its instructions and on one tool result), so the agent can ask you to restart. It checks npm at most once a day; turn it off with RANLA_MCP_NO_UPDATE_CHECK=1.

Create a key on the dashboard API keys page; stx_ keys also work. The Ranla agent tools need a full-access key — a sending-only key gets a 403 on every arc_* tool.

Defaults: mail API https://api.ranla.ai, Ranla app APIs https://app.ranla.ai.
SUPERSENDTX_API_KEY / SUPERSENDTX_API_URL / SUPERSENDTX_APP_URL are also accepted. Set one family, not both: when both are set, SUPERSENDTX_API_KEY and SUPERSENDTX_API_URL win over RANLA_API_KEY and RANLA_API_URL.

With --http, the key comes from each request's Authorization: Bearer header, not from RANLA_API_KEY.

Use

Start with ranla_open_thread, then ranla_message to ask Ranla for anything, or ranla_command to run one of its commands (campaign list, page propose) yourself. When a step needs approval, answer it with ranla_list_approvals → ranla_approve or ranla_reject. Mail tools (send_email, domains, templates, webhooks, deliverability) are on the same server.

See MCP docs.

License

MIT