ranla-mcp 0.6.30 → 0.6.32
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -5
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,22 +1,61 @@
|
|
|
1
1
|
# ranla-mcp
|
|
2
2
|
|
|
3
|
-
MCP server for Ranla —
|
|
3
|
+
MCP server for Ranla — the Ranla agent tools plus transactional mail tools, for Cursor, Claude Code, and other MCP clients (stdio or `--http`).
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
5
|
+
## Hosted (no install)
|
|
6
|
+
|
|
7
|
+
Connect to the hosted server and sign in with OAuth when your client asks. No API key:
|
|
8
|
+
|
|
9
|
+
```json
|
|
10
|
+
{
|
|
11
|
+
"mcpServers": {
|
|
12
|
+
"ranla": {
|
|
13
|
+
"url": "https://mcp.ranla.ai/mcp"
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
}
|
|
7
17
|
```
|
|
8
18
|
|
|
19
|
+
Claude Code: `claude mcp add --transport http ranla https://mcp.ranla.ai/mcp`, then run `/mcp` to sign in.
|
|
20
|
+
|
|
21
|
+
## Local (stdio)
|
|
22
|
+
|
|
9
23
|
```bash
|
|
10
24
|
export RANLA_API_KEY=rnl_your_key_here
|
|
25
|
+
npx -y ranla-mcp
|
|
11
26
|
# optional overrides:
|
|
12
27
|
# export RANLA_API_URL=https://api.ranla.ai
|
|
13
28
|
# export RANLA_APP_URL=https://app.ranla.ai
|
|
14
29
|
```
|
|
15
30
|
|
|
31
|
+
Cursor `.cursor/mcp.json`:
|
|
32
|
+
|
|
33
|
+
```json
|
|
34
|
+
{
|
|
35
|
+
"mcpServers": {
|
|
36
|
+
"ranla": {
|
|
37
|
+
"command": "npx",
|
|
38
|
+
"args": ["-y", "ranla-mcp"],
|
|
39
|
+
"env": {
|
|
40
|
+
"RANLA_API_KEY": "rnl_your_key_here"
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
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.
|
|
48
|
+
|
|
16
49
|
Defaults: mail API `https://api.ranla.ai`, Ranla app APIs `https://app.ranla.ai`.
|
|
17
|
-
`SUPERSENDTX_API_KEY` / `SUPERSENDTX_API_URL` / `SUPERSENDTX_APP_URL` are also accepted.
|
|
50
|
+
`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`.
|
|
51
|
+
|
|
52
|
+
With `--http`, the key comes from each request's `Authorization: Bearer` header, not from `RANLA_API_KEY`.
|
|
53
|
+
|
|
54
|
+
## Use
|
|
55
|
+
|
|
56
|
+
Start with `arc_ensure_thread`, then `arc_message` to drive Ranla without the dashboard. When a step needs approval, answer it with `arc_list_approvals` → `arc_approve` or `arc_reject`. Mail tools (`send_email`, domains, templates, webhooks, deliverability) are on the same server.
|
|
18
57
|
|
|
19
|
-
|
|
58
|
+
See [MCP docs](https://docs.ranla.ai/ai/mcp).
|
|
20
59
|
|
|
21
60
|
## License
|
|
22
61
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ranla-mcp",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.32",
|
|
4
4
|
"description": "Ranla MCP server — mail + Ranla agent tools for Cursor and Claude",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
"prepublishOnly": "npm run build"
|
|
41
41
|
},
|
|
42
42
|
"dependencies": {
|
|
43
|
-
"supersendtx-mcp": "0.6.
|
|
43
|
+
"supersendtx-mcp": "0.6.32"
|
|
44
44
|
},
|
|
45
45
|
"devDependencies": {
|
|
46
46
|
"tsup": "^8.5.0",
|