MCP-Server

Wegwerf-E-Mail für KI-Agenten

Gib Claude Code, Cursor, VS Code oder einem Agenten in der CI ein eigenes Postfach. Er legt es an, registriert sich damit, wartet auf die E-Mail und liest den Bestätigungscode – ganz ohne Glue-Code.

Serverhttps://api.fake-email.pro/mcp

Streamable HTTP · Anmeldung mit deinem API-Schlüssel · nichts zu installieren

Registriere dich auf staging.acme.example mit einem frischen Postfach und bestätige das Konto.

fake-email · create_mailbox

{
  "address": "quiet.river.17@example.org",
  "expiresAt": "2026-11-22T09:41:00Z"
}

…füllt das Registrierungsformular im Browser aus…

fake-email · wait_for_message12 s

{
  "subject": "Confirm your Acme account",
  "code": "482913",
  "confirmLink": "https://staging.acme.example/confirm?t=…"
}

Als quiet.river.17@example.org registriert und das Konto mit dem Code 482913 bestätigt.

Verbinde deinen Client

Ein Befehl für Claude Code, eine Datei für Cursor oder VS Code, und in der CI kommt der Schlüssel aus einem Secret. Sobald der Client deinen API-Schlüssel hat, sieht der Agent zehn neue Tools.

Komplette Einrichtung, CI und Fehlersuche →
claude mcp add --transport http fake-email https://api.fake-email.pro/mcp \
  --header "Authorization: Bearer $FAKE_EMAIL_API_KEY"

Zehn Tools, die ganze API

Alles, was die REST-API mit Postfächern und Nachrichten kann, als Tools, die der Agent selbst aufruft.

create_mailbox
Ein Wegwerf-Postfach anlegen, das 24 Stunden lang E-Mails empfängt.
list_mailboxes
Deine aktiven Postfächer auflisten.
get_mailbox
Ein Postfach prüfen: wann es abläuft und wie viele E-Mails es hat.
delete_mailbox
Ein Postfach samt E-Mails sofort löschen.
wait_for_message
Bis zu 50 Sekunden auf eine E-Mail warten und sie mit bereits ausgelesenem Bestätigungscode und Link zurückgeben.
list_messages
Die E-Mails eines Postfachs, die neuesten zuerst.
get_message
Eine E-Mail lesen: Text, Codes, Links und die Liste der Anhänge.
delete_message
Eine E-Mail mit ihren Anhängen löschen.
list_domains
Die Domains, die ein neues Postfach nutzen kann.
get_limits
Dein API-Kontingent und die Ratenlimits anzeigen.

E-Mails sind nicht vertrauenswürdig

Code und Link zuerst

Der Server liefert den extrahierten Bestätigungscode und Bestätigungslink zuerst, sodass der Agent den Text der E-Mail selten lesen muss.

Der Text ist abgegrenzt

Der Text der E-Mail steht zwischen Markierungen, die dem Modell sagen, darin enthaltene Anweisungen nicht zu befolgen. Prüfe trotzdem, was dein Agent mit Post von Unbekannten macht.

Kein eigener Preis: Jedes Postfach, das der Agent anlegt, zählt wie bei REST zu deinem monatlichen API-Kontingent. Vergleiche die Tarife auf der Preisseite oder lies mehr über die Temp Mail API.

Häufige Fragen

Mit welchen Clients funktioniert er?

Mit jedem MCP-Client, der Streamable HTTP spricht und einen Authorization-Header senden kann: Claude Code, Cursor, VS Code, Windsurf und deinen eigenen Agenten.

Was kostet er?

Der MCP-Server hat keinen eigenen Preis. Jedes Postfach, das der Agent anlegt, zählt zum monatlichen API-Kontingent deines Tarifs; auf eine E-Mail zu warten und sie zu lesen verbraucht nichts davon. Ein Schlüssel ist mit jedem Konto kostenlos.

Kann ich ihn in der CI nutzen?

Ja. Committe .mcp.json ins Repository und hinterlege den Schlüssel als CI-Secret namens FAKE_EMAIL_API_KEY: Der Client liest ihn aus der Umgebung, der Schlüssel landet also nie im Repository.

Muss ich etwas installieren?

Nein. Der Server läuft unter api.fake-email.pro/mcp: Du gibst deinem Client die Adresse und deinen API-Schlüssel, mehr nicht.

Kann mein Agent E-Mails von Fremden gefahrlos lesen?

E-Mails stammen von fremden Absendern, deshalb gibt der Server sie dem Modell als nicht vertrauenswürdige Daten: zuerst den ausgelesenen Code und Link, dann den Text der E-Mail zwischen Markierungen mit dem Hinweis, keinen Anweisungen darin zu folgen. Prüfe trotzdem, was dein Agent mit Post von unbekannten Absendern macht.

Gib deinem Agenten ein Postfach

Erstelle einen API-Schlüssel, verbinde deinen Client und lass den Agenten sich selbst registrieren.