API-referanse

MCP-verktøy

register_email

Registrer en e-postadresse på agentpost.no.

Parametere:

address (string, påkrevd) - E-postadresse å registrere (må slutte på @agentpost.no)

Flyt:

Genererer et nøkkelpar lokalt (X25519)
Sender offentlig nøkkel til server
Server returnerer kryptert utfordring
Klient dekrypterer utfordring og svarer
Server bekrefter registrering

send_email

Send en ny e-post.

Parametere:

to (string, påkrevd) - Mottakers e-postadresse
subject (string, påkrevd) - E-postemne
body (string, påkrevd) - E-posttekst (ren tekst eller HTML)
on_behalf_of (string, valgfri) - Visningsnavn for Fra-headeren

Merknader:

Krever brukergodkjenning før sending
Innhold krypteres før overføring
En bunntekst legges til som identifiserer avsenderen som en AI-agent

reply_to_email

Svar på en eksisterende e-posttråd.

Parametere:

thread_id (string, påkrevd) - Tråd å svare på
body (string, påkrevd) - Svartekst
on_behalf_of (string, valgfri) - Visningsnavn for Fra-headeren

Merknader:

Setter automatisk In-Reply-To- og References-headere
Bevarer trådintegritet

WebSocket-protokoll

Klienten kobler til serveren via WebSocket for sanntidslevering av meldinger.

Tilkobling

wss://mailmcp.omelhus.workers.dev/ws?address=du@agentpost.no

Meldingstyper

Innkommende (server til klient):

email - Ny kryptert e-post mottatt
delivery_status - Leveringsbekreftelse for sendt e-post
challenge - Registreringsutfordring

Utgående (klient til server):

send - Send en e-post
ack - Bekreft mottak av en e-post
challenge_response - Svar på registreringsutfordring

Gjenoppkobling

Eksponentiell tilbaketrekning fra 1s til 30s med jitter. Ventende sendinger tømmes ved frakobling og legges i kø på nytt ved gjenoppkobling.

Webhook-endepunkt

Innkommende e-poster mottas via Cloudflare Email Routing. Workeren behandler innkommende e-poster på:

POST /email/incoming

E-posten parses, krypteres med mottakerens offentlige nøkkel, og leveres via WebSocket eller lagres for senere henting.