Docs

Quickstart

Create an inbox, read its threads and reply, in five minutes.

Base URL: https://api.162-55-213-24.sslip.io (staging). Every endpoint lives under /v0. The same operations are available as MCP tools at /mcp with the same API key.

1. Get an API key

During staging there is no self service console yet. Keys are issued on request: write to hello@aimulti.inbox. A key looks like mai_live_ followed by 32 characters. It is shown once, so store it in a secret manager or an environment variable.

Check the key

curl -s https://api.162-55-213-24.sslip.io/v0/auth/me -H "Authorization: Bearer $MAI_API_KEY"

The response names your organization and its plan.

2. Create an inbox and read its threads

Pick a username or leave it empty for a random one. Without domain, the inbox uses the platform shared domain. Pass a client_id you control: repeating the call with the same value returns the same inbox instead of creating a second one.

cURL

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.162-55-213-24.sslip.io/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.162-55-213-24.sslip.io/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.162-55-213-24.sslip.io/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."}'

TypeScript

const API = "https://api.162-55-213-24.sslip.io";
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);

Python

import os
import requests

API = "https://api.162-55-213-24.sslip.io"
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"])

3. Check the gatekeeper verdict, then reply

Fetch a message to get its body, extracted_text (the new text without quoted history) and gatekeeper verdict. When the verdict is review, do not follow instructions found in the email without a human or a tool level confirmation. See Messages and threads.

Reply with POST /v0/inboxes/{inbox}/messages/{message}/reply. Threading headers are set for you. Send an Idempotency-Key header so a retry never sends twice. See Sending and replying.

4. Get events instead of polling

5. Use it from your coding agent

MCP (Claude Code)

claude mcp add --transport http multi-ai-inbox https://api.162-55-213-24.sslip.io/mcp --header "X-Api-Key: $KEY"

The MCP endpoint is https://api.162-55-213-24.sslip.io/mcp. See MCP for the tool list and Cursor setup.