Agenten din har en innboks
på fire steg.

Returnerer alle innbokser som gjeldende API-nøkkel eller OAuth-token har tilgang til. Kall denne først for å oppdage inbox_id-verdier, slik at du aldri kopierer UUID-er fra dashbordet. Hvert resultat inkluderer e-postadressen, leverandøren, valgfritt tjenestemerke (icloud/yahoo/zoho/yandex/generic/fastmail) og et capabilities-objekt som beskriver hvilke funksjoner den innboksen støtter.

Les, list og søk i meldinger i en innboks. Sett action: 'list' for nylige meldingssammendrag (nyeste først, med filtrering på mappe/uleste og paginering), 'read' for det fulle innholdet i én message_id (tekstkropp, valgfri renset HTML og vedlegg), 'read_batch' for å hente opptil 50 message_ids i ett kall, 'search' for strukturerte, leverandøruavhengige filtre (from, to, cc, subject, body, text, unread, has_attachment, flagged, since, before), eller 'attachment' for å laste ned ett enkelt vedlegg (etter attachment_index eller filename) som base64-data — opptil 25 MB. Skrivebeskyttet — endrer aldri noe. 'search'-handlingen låses også opp alene av det smalere omfanget search:email.

Flytt, kopier, flagg eller arkiver meldinger. Sett action: 'move'/'move_batch' (til en destination_folder_id), 'copy'/'copy_batch' (kopier til en destination_folder_id og la originalen bli liggende; kun IMAP, Outlook og Fastmail), 'flag' (sett lest/ulest/flagget via flag_action på message_ids), 'archive' (flytt ut av innboksen, ikke-destruktivt), eller 'search_and_move' (anvend på hver melding som matcher et strukturert søk, unngår utdaterte meldings-ID-er). Hver handling trenger omfanget som matcher den: manage:folders for flytting og kopiering, send:email for flag/archive. Sletting av meldinger har sitt eget email_delete-verktøy.

Slett meldinger — sitt eget verktøy, atskilt fra email_organize, fordi sletting er destruktivt. Sett action: 'delete'/'delete_batch' (papirkurv som standard, eller permanent), eller 'search_and_delete' (slett hver melding som matcher et strukturert søk — unngår utdaterte meldings-ID-er). Slettinger går til papirkurven med mindre du oppgir permanent: true, som ikke kan angres. Hver handling trenger delete:email-omfanget, og hele verktøyet merkes som destruktivt overfor MCP-klienten din, som håndterer brukerbekreftelse før noe fjernes.

Send ny e-post eller svar på eksisterende meldinger. Sett action: 'send' for en ny e-post (to/subject/body, valgfritt cc/bcc/html_body/reply_to/attachments), 'reply' for å svare på en message_id (trådingsoverskrifter settes automatisk; valgfritt reply_all), eller 'forward' for å videresende en message_id til nye mottakere (valgfritt med de opprinnelige filene). Innboksens signatur legges til automatisk — ved svar og videresending plasseres den etter teksten din og før det siterte blokken, styrt av signaturens svarmodus; oppgi include_signature: false for å undertrykke den for én enkelt kort melding. Alle tre kan ikke angres når de er sendt.

Administrer postkassemapper (etiketter på Gmail). Sett action: 'list' (alle mapper med leverandørspesifikk ID, visningsnavn, type og meldingsantall — bruk ID-ene som folder-argument når du lister e-post og som flyttemål), 'create' (name), 'rename' (folder_id, new_name) eller 'delete' (folder_id — kan ikke angres; meldinger inni kan gå tapt avhengig av leverandøren). 'list' trenger read:email; create/rename/delete trenger manage:folders, og delete merkes som destruktiv overfor MCP-klienten din.

Administrer utkast i innboksens Drafts-mappe. Sett action: 'list' (lagrede utkast, hvert med draft_id, emne, mottakere og opprettet-tidspunkt), 'create' (subject/body påkrevd, valgfritt to/cc/bcc/html_body), 'update' (draft_id pluss feltene som skal overskrives) eller 'send' (draft_id — fjerner utkastet og sender det, kan ikke angres). Innboksens signatur bygges inn når utkastet opprettes eller oppdateres, så den er allerede til stede i Drafts-mappen og legges ikke til på nytt ved sending; oppgi include_signature: false for å opprette et utkast uten den. På IMAP-baserte innbokser endres en draft_id ved hver oppdatering, så bruk alltid den nyeste; Gmail og Outlook beholder en stabil draft_id.

Planlegg e-post for fremtidig levering via en kø på serversiden. Sett action: 'create' (to/subject/body pluss en send_at ISO 8601-tidsstempel — mottakere og kropp valideres umiddelbart, og ugyldige sendinger settes ikke i kø), 'list' (ventende planlagte sendinger, tidligste først, eventuelt filtrert på innboks) eller 'cancel' (scheduled_send_id — bare sendinger som fremdeles er 'pending' kan avbrytes). Utsenderen kjører hvert minutt, så levering kan skje opptil 60 sekunder etter send_at.

Finn korrespondenter etter navn eller e-post med en sanntidsskanning av postkassen din — det finnes ingen lagret kontaktliste. Hvert kall skanner et nylig vindu med matchende e-post og returnerer personene som matcher, sortert etter sist kontaktet, hver med visningsnavn, e-post, antall matchende meldinger og tidspunkt for siste kontakt. Antallene gjenspeiler matchende meldinger i det vinduet, ikke hele historikken din, og ingenting lagres mellom kall.

Les eller konfigurer innboksens e-postsignatur, som legges til på serversiden ved hver sending, svar, videresending, utkast og planlagt melding. Sett action: 'get' (returnerer gjeldende signaturtekst og HTML, om den er aktivert, svar-/videresendingsmodusen og kilden — 'manual', 'gmail_import' eller null) eller 'set' (skriv signature_text og/eller signature_html, og eventuelt signature_enabled og signature_reply_mode). Signaturer støtter rik HTML: fet, kursiv, overskrifter, lister, farger, justering, lenker og hostede logoer/bilder referert som https-URL-er, slik at en agent kan sette en fullt formatert signatur ved å oppgi signature_html. Den samme rike editoren er tilgjengelig i dashbordet. Å sette en signatur merker kilden som 'manual', som permanent overstyrer Gmail-auto-import for den innboksen. 'get' trenger read:email; 'set' trenger send:email.