Let your AI agents
run real email
conversations.

claude mcp add --transport http sendraven https://mcp.sendraven.ai/mcp

https://mcp.sendraven.ai/mcp

https://mcp.sendraven.ai/mcp

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

codex mcp add sendraven --url https://mcp.sendraven.ai/mcp

gemini mcp add --transport http sendraven https://mcp.sendraven.ai/mcp

code --add-mcp '{"name":"sendraven","type":"http","url":"https://mcp.sendraven.ai/mcp"}'

{
  "mcpServers": {
    "sendraven": { "serverUrl": "https://mcp.sendraven.ai/mcp" }
  }
}

curl -X POST https://api.sendraven.ai/v1/emails \
  -H "Authorization: Bearer $SENDRAVEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "from": "Acme <hi@mail.acme.com>",
    "to": "maya@acme.com",
    "subject": "Your invoice for August",
    "html": "<p>Hi Maya, it is attached.</p>"
  }'

# 202 {"id": "…", "status": "queued", "thread_id": "…"}

const res = await fetch("https://api.sendraven.ai/v1/emails", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SENDRAVEN_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    from: "Acme <hi@mail.acme.com>",
    to: "maya@acme.com",
    subject: "Your invoice for August",
    html: "<p>Hi Maya, it is attached.</p>",
  }),
});

const email = await res.json();
// { id: "…", status: "queued", thread_id: "…" }

import os, uuid, requests

res = requests.post(
    "https://api.sendraven.ai/v1/emails",
    headers={
        "Authorization": f"Bearer {os.environ['SENDRAVEN_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "from": "Acme <hi@mail.acme.com>",
        "to": "maya@acme.com",
        "subject": "Your invoice for August",
        "html": "<p>Hi Maya, it is attached.</p>",
    },
)

email = res.json()
# {"id": "…", "status": "queued", "thread_id": "…"}

body, _ := json.Marshal(map[string]string{
	"from":    "Acme <hi@mail.acme.com>",
	"to":      "maya@acme.com",
	"subject": "Your invoice for August",
	"html":    "<p>Hi Maya, it is attached.</p>",
})

req, _ := http.NewRequest("POST", "https://api.sendraven.ai/v1/emails", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("SENDRAVEN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Idempotency-Key", uuid.NewString())

res, err := http.DefaultClient.Do(req)
// 202 and { "id": "…", "status": "queued" }

require "net/http"
require "json"
require "securerandom"

uri = URI("https://api.sendraven.ai/v1/emails")
req = Net::HTTP::Post.new(uri, {
  "Authorization" => "Bearer #{ENV["SENDRAVEN_API_KEY"]}",
  "Content-Type" => "application/json",
  "Idempotency-Key" => SecureRandom.uuid,
})
req.body = {
  from: "Acme <hi@mail.acme.com>",
  to: "maya@acme.com",
  subject: "Your invoice for August",
  html: "<p>Hi Maya, it is attached.</p>",
}.to_json

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
email = JSON.parse(res.body)
# {"id" => "…", "status" => "queued"}

$ch = curl_init("https://api.sendraven.ai/v1/emails");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("SENDRAVEN_API_KEY"),
    "Content-Type: application/json",
    "Idempotency-Key: " . bin2hex(random_bytes(16)),
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "from" => "Acme <hi@mail.acme.com>",
    "to" => "maya@acme.com",
    "subject" => "Your invoice for August",
    "html" => "<p>Hi Maya, it is attached.</p>",
  ]),
]);

$email = json_decode(curl_exec($ch), true);
// ["id" => "…", "status" => "queued"]

var body = """
    {"from": "Acme <hi@mail.acme.com>",
     "to": "maya@acme.com",
     "subject": "Your invoice for August",
     "html": "<p>Hi Maya, it is attached.</p>"}
    """;

var req = HttpRequest.newBuilder(URI.create("https://api.sendraven.ai/v1/emails"))
    .header("Authorization", "Bearer " + System.getenv("SENDRAVEN_API_KEY"))
    .header("Content-Type", "application/json")
    .header("Idempotency-Key", UUID.randomUUID().toString())
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

var res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
// res.body(): {"id": "…", "status": "queued"}

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("SENDRAVEN_API_KEY"));
http.DefaultRequestHeaders.Add("Idempotency-Key", Guid.NewGuid().ToString());

var res = await http.PostAsJsonAsync("https://api.sendraven.ai/v1/emails", new {
    from = "Acme <hi@mail.acme.com>",
    to = "maya@acme.com",
    subject = "Your invoice for August",
    html = "<p>Hi Maya, it is attached.</p>",
});

// 202 Accepted and {"id": "…", "status": "queued"}

let res = reqwest::Client::new()
    .post("https://api.sendraven.ai/v1/emails")
    .bearer_auth(std::env::var("SENDRAVEN_API_KEY")?)
    .header("Idempotency-Key", uuid::Uuid::new_v4().to_string())
    .json(&serde_json::json!({
        "from": "Acme <hi@mail.acme.com>",
        "to": "maya@acme.com",
        "subject": "Your invoice for August",
        "html": "<p>Hi Maya, it is attached.</p>",
    }))
    .send()
    .await?;

// 202 and {"id": "…", "status": "queued"}

{
  "name": "support-agent",
  "scopes": ["emails:send", "threads:read"],
  "daily_send_limit": 200,
  "allowed_recipients": ["@acme.com"],
  "requires_approval": true
}

403 { "error": { "type": "recipient_not_allowed" } }
429 { "error": { "type": "daily_limit" } }

202 { "status": "pending_approval",
      "approval_id": "apr_4c…" }