Inboxes for AI agents. Hosted in Europe.

export MAI_API_KEY=mai_live_your_key

# 1. Create an inbox (repeat client_id to get the same inbox back)
curl -s -X POST https://api.mueslimail.com/v0/inboxes \
  -H "Authorization: Bearer $MAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "support-agent", "client_id": "support-agent"}'

# 2. Read the conversations it received
curl -s "https://api.mueslimail.com/v0/inboxes/support-agent@your-domain.eu/threads?limit=10" \
  -H "Authorization: Bearer $MAI_API_KEY"

# 3. Reply in the same thread (safe to retry with the same Idempotency-Key)
curl -s -X POST "https://api.mueslimail.com/v0/inboxes/support-agent@your-domain.eu/messages/$MESSAGE_ID/reply" \
  -H "Authorization: Bearer $MAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: reply-$MESSAGE_ID" \
  -d '{"text": "Thanks, the invoice is approved."}'

const API = "https://api.mueslimail.com";
const headers = {
  Authorization: `Bearer ${process.env.MAI_API_KEY}`,
  "Content-Type": "application/json",
};

type Inbox = { inbox_id: string; email: string };
type Thread = { thread_id: string; subject: string; preview: string; labels: string[] };

async function call<T>(path: string, init: RequestInit = {}): Promise<T> {
  const res = await fetch(API + path, { ...init, headers: { ...headers, ...init.headers } });
  if (!res.ok) {
    const err: { code: string; message: string } = await res.json();
    throw new Error(`${res.status} ${err.code}: ${err.message}`);
  }
  return res.json() as Promise<T>;
}

// Create an inbox; repeating client_id returns the same inbox.
const inbox = await call<Inbox>("/v0/inboxes", {
  method: "POST",
  body: JSON.stringify({ username: "support-agent", client_id: "support-agent" }),
});

// List its threads, newest first.
const { threads } = await call<{ threads: Thread[] }>(
  `/v0/inboxes/${encodeURIComponent(inbox.inbox_id)}/threads?limit=10`,
);
console.log(inbox.email, threads.length);

import os
import requests

API = "https://api.mueslimail.com"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['MAI_API_KEY']}"

# Create an inbox; repeating client_id returns the same inbox.
inbox = session.post(f"{API}/v0/inboxes", json={
    "username": "support-agent",
    "client_id": "support-agent",
}).json()

# List its threads, newest first.
threads = session.get(
    f"{API}/v0/inboxes/{inbox['inbox_id']}/threads", params={"limit": 10}
).json()["threads"]

for thread in threads:
    print(thread["subject"], thread["labels"])

claude mcp add --transport http mueslimail https://api.mueslimail.com/mcp --header "X-Api-Key: $KEY"