Give your agent a real email inbox.

// Claude Desktop · ~/.config/claude/claude_desktop_config.json
{
  "mcpServers": {
    "catchotp": {
      "command": "npx",
      "args": ["-y", "@catchotp/mcp"],
      "env": {
        "CATCHOTP_API_KEY": "sk_live_..."
      }
    }
  }
}

// Inside an MCP-aware client (Claude Code, Cursor, etc.)
// The agent calls these tools directly — no glue code needed.

> Use catchotp to create an inbox, sign up for example.com, and read the verification code.

The agent will:
  1. call catchotp.create_inbox  →  { id, address: "abc123@inbox.catchotp.com" }
  2. drive the signup form with the address (via its browser/HTTP tool)
  3. call catchotp.wait_for_otp(inbox_id) →  { code: "493021" }
  4. submit the code and confirm verification

// agent.ts — a minimal email-aware agent loop
import Anthropic from '@anthropic-ai/sdk';
import { CatchOTP } from '@catchotp/sdk';

const ai = new Anthropic();
const otp = new CatchOTP({ apiKey: process.env.CATCHOTP_KEY! });

// Tools the model can call
const tools = [
  {
    name: 'create_inbox',
    description: 'Create a fresh email inbox. Returns { id, address }.',
    input_schema: { type: 'object', properties: {}, required: [] },
  },
  {
    name: 'wait_for_otp',
    description: 'Block until a one-time code arrives at the given inbox. Returns { code }.',
    input_schema: {
      type: 'object',
      properties: {
        inbox_id: { type: 'string' },
        timeout_seconds: { type: 'number', default: 60 },
      },
      required: ['inbox_id'],
    },
  },
];

const dispatch = {
  create_inbox: () => otp.inboxes.create({ mode: 'ephemeral', ttlMinutes: 30 }),
  wait_for_otp: ({ inbox_id, timeout_seconds }: any) =>
    otp.inboxes.waitForOtp(inbox_id, { timeoutSeconds: timeout_seconds ?? 60 }),
};

const messages: any[] = [
  { role: 'user', content: 'Sign up for example.com using a fresh inbox and verify the OTP.' },
];

// Standard agent loop
while (true) {
  const res = await ai.messages.create({
    model: 'claude-opus-4-5',
    max_tokens: 1024,
    tools,
    messages,
  });
  messages.push({ role: 'assistant', content: res.content });
  if (res.stop_reason !== 'tool_use') break;

  const toolResults = [];
  for (const block of res.content) {
    if (block.type !== 'tool_use') continue;
    const fn = (dispatch as any)[block.name];
    const result = await fn(block.input);
    toolResults.push({
      type: 'tool_result',
      tool_use_id: block.id,
      content: JSON.stringify(result),
    });
  }
  messages.push({ role: 'user', content: toolResults });
}