Dokumentasjon

Agenten din har en innboks
på fire steg.

Koble til hvilken som helst e-postkonto, lim inn én URL i en OAuth-kompatibel MCP-klient og godkjenn. Klienter uten OAuth bruker en API-nøkkel i stedet. Full verktøyreferanse og tilkoblingsveiledning nedenfor.

Hurtigstart OAuth (claude.ai)Verktøyreferanse Sikkerhetsmodell Leverandørstøtte

Hurtigstart

Oppe og kjører på minutter.

Ingen SDK kreves. MCPEmails snakker standard MCP over HTTP, så det passer rett inn i enhver MCP-kompatibel agent.

01Registrer deg og koble til en innboks

Opprett kontoen din og koble til Gmail

Registrer deg på mcpemails.com, og gå deretter til Dashboard → Inboxes → Connect Inbox. Velg Gmail, iCloud, Fastmail eller en hvilken som helst IMAP-innboks, og fullfør deretter OAuth-flyten eller lim inn et app-passord. Innboksen din er klar på under ett minutt.

Koble til innboksen din →

02Opprett en API-nøkkel

Generer et bearer-token for agenten din

I Dashbord → API-nøkler klikker du «Opprett nøkkel». Gi den navn, velg omfangene agenten din trenger (read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email og manage:automations), og kopier nøkkelen. Den vises bare én gang.

# Your key looks like this:
mcpe_live_AbCdEfGhIjKlMnOpQrStUvWxYz123456

03Legg MCPEmails til i agenten din

Lim MCP-endepunktet inn i klienten din

Velg fanen for klienten din nedenfor. MCP-klienter med OAuth 2.0-støtte (claude.ai, Claude Desktop, Cursor og andre) limer bare inn URL-en og godkjenner, ingen API-nøkkel nødvendig. Klienter uten OAuth, samt skriptbasert tilgang, bruker API-nøkkelen fra steg 02.

json

# OAuth-capable clients (claude.ai, Claude Desktop, Cursor…)
# No API key required. Paste the URL, click Connect, authorize.
#
# Example: claude.ai
#   1. Go to claude.ai → Customize → Connectors
#   2. Click "Add connector" and paste this URL:
#
#        https://mcpemails.com/api/mcp
#
#   3. Click Connect and sign in with your mcpemails account.
#   4. Every tool your approved scopes allow is live immediately.
#
# Claude Desktop and Cursor follow the same OAuth flow when
# the server URL is configured in their MCP settings.

04Gjør ditt første kall

Be agenten din om å sjekke innboksen din

Ingen kopiering av innboks-UUID-er. Agenten din kaller inbox_list først for å oppdage hver tilkoblet innboks og dens UUID, og deretter spør du: "Sjekk innboksen min og oppsummer de 5 siste uleste meldingene."

# The agent calls inbox_list first, so no hardcoded UUIDs.
# System prompt (optional, for multi-inbox setups):
You have access to email via MCPEmails.
Start by calling inbox_list to discover available inboxes.

Endepunkt

Én URL, standard MCP.

All trafikk går til ett enkelt Streamable HTTP-endepunkt. Autentiser med et bearer-token fra dashbordet ditt.

POSThttps://mcpemails.com/api/mcp

Send en JSON-RPC 2.0-forespørselskropp. Støttede metoder: initialize, tools/list, tools/call.

Transport: Streamable HTTP (MCP 2025-06-18)

Autentisering: Authorization: Bearer <api-key>

Hastighetsgrenser: 100 req/min · 1 000/t · 10 000/dag per nøkkel, pluss arbeidsområdets tak for planen din

Responsformat: JSON-RPC 2.0. Vellykkede resultater bærer også et typet structuredContent-objekt

Initialize-håndtrykk

bash

curl -X POST https://mcpemails.com/api/mcp \
  -H "Authorization: Bearer mcpe_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "clientInfo": { "name": "my-agent", "version": "1.0" },
      "capabilities": {}
    }
  }'

Polling, ikke push

MCPEmails er kun forespørsel/svar: hvert resultat kommer fra et verktøykall agenten din gjør. Det finnes ingen webhooks, push-varsler eller hendelser initiert av serveren. En innkommende e-post utløser aldri et agentkall av seg selv. For å reagere på ny e-post bør agenten din polle etter en tidsplan, f.eks. kalle email_read med action: "list" og unread_only: true med intervallet arbeidsflyten din trenger (vær oppmerksom på rategrensene over).

Bygget for ekte innboksarbeid

Mer kontroll, uten mer verktøyrot.

Dette er leverandørbevisste egenskaper i det samme kompakte, handlingsbaserte MCP-grensesnittet, ikke en egen verktøykatalog for hvert særtilfelle.

Sendegodkjenning håndhevet på serveren

Slå på godkjenning per innboks i dashbordet for å holde tilbake sendinger, svar, videresendinger, utkastsendinger og planlagte sendinger. Agenten får et ventende resultat, og et medlem av arbeidsområdet godkjenner eller avviser det i dashbordet før noe sendes.

Kompatibilitetsprofiler for leverandører

Kall inbox_list for å se en versjonert profil for hver innboks. Den merker normaliserte operasjoner som eksakte, forskjellige eller utilgjengelige, slik at agenter kan velge portable arbeidsflyter uten å late som om leverandørene er like.

Vedlegg og original e-post

Les et valgt vedlegg som midlertidig tekst for støttede tekstfiler, CSV, HTML, JSON og PDF-er med tekstlag, eller last ned originalen leverandøren har lagret, som en portabel .eml. Uthentingen kjører ikke innebygd kode og gjør ikke OCR på bilder.

Pålitelig automatisering som kan etterprøves

Gjenbruk en idempotency_key for trygt å prøve den samme utgående forespørselen på nytt i 24 timer. Masseorganiseringsjobber viser status i dashbordet og tar imot avbestillingsforespørsler, og verken meldingsinnhold eller søkeord lagres i disse jobbpostene.

Veiledede MCP-arbeidsflyter

Klienter som støtter MCP-prompter, kan tilby innebygde rutiner for grundig innbokstriagering, gjennomgang av åpne tråder, forberedelse av svarutkast, organiseringsforslag og gjennomgang av planlagte sendinger. Prompter gir aldri tilganger og kjører aldri av seg selv.

Svarutkast i tråden og Gmail Send As

Opprett et usendt svar i den opprinnelige samtalen for menneskelig gjennomgang. Gmail-sendinger, -svar og -videresendinger kan bare velge en Send As-identitet som er verifisert av leverandøren og returnert av inbox_list; andre leverandører bruker den tilkoblede adressen sin.

OAuth-tilkobling

Null konfigurasjon for OAuth-kompatible klienter.

MCP-klienter som støtter OAuth 2.0 (claude.ai, Claude Desktop, Cursor og andre) kobler til automatisk via authorization code + PKCE. Ingen API-nøkkel, ingen konfigurasjonsfil. Lim inn URL-en og klikk Connect.

Steg 1: Gå til claude.ai → Customize → Connectors → Add connector

Steg 2: Lim inn https://mcpemails.com/api/mcp som server-URL

Steg 3: Klikk Connect. MCPEmails åpner et godkjenningsskjermbilde

Steg 4: Logg inn med mcpemails-kontoen din og godkjenn tilgang

Ferdig: Alle verktøyene som de godkjente omfangene dine tillater, er aktive. claude.ai fornyer tokens automatisk

Hvordan det fungerer under panseret

claude.ai registrerer seg selv via RFC 7591 Dynamic Client Registration, så du forhåndsregistrerer aldri en client-ID.

Godkjenning bruker OAuth 2.0 Authorization Code + PKCE (RFC 7636), så ingen client secret overføres noensinne.

Tokens er avgrenset til nøyaktig de tillatelsene du godkjenner: read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email og manage:automations.

Bruker du en klient uten OAuth-støtte? Opprett en API-nøkkel i Dashboard → API Keys og send den som et bearer-token. API-nøkkel- og OAuth-tilkoblinger bruker samme MCP-endepunkt og den samme verktøykatalogen.

Verktøyreferanse

11 verktøy. Alle e-postoperasjonene agenten din trenger.

Å angi innboks er valgfritt. Når nøkkelen din har nøyaktig én innboks, løser hvert per-innboks-verktøy den automatisk (ingen inbox_id nødvendig). Med flere innbokser oppgir du enten inbox_id (UUID-en fra inbox_list) eller inbox (innboksens e-postadresse). De fleste verktøy tar et action-argument som velger operasjonen; merkene viser hvilke omfang hvert verktøy trenger, og tools/list returnerer bare verktøyene nøkkelen din (eller OAuth-tokenet) har omfang for. Klikk «Vis eksempel» for å se en full forespørsel og respons.

inbox_listread:email email_readread:emailsearch:email email_organizemanage:folders email_deletedelete:email email_composesend:email folderread:emailmanage:folders draftmanage:drafts scheduleschedule:email contact_searchmanage:contacts automationmanage:automations signatureread:emailsend:email

inbox_listread:email

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.

Parameter	Type	Påkrevd	Beskrivelse
`provider`	enum	valgfri	Valgfritt filter: returner bare innbokser betjent av denne leverandøren. Én av: gmail, fastmail, imap. Utelat for å liste alle innbokser nøkkelen har tilgang til.
`include_capabilities`	boolean	valgfri	Om hver innboks inkluderer capabilities-objektet sitt (hvilke funksjoner den støtter). Standard true; sett false for en kompakt liste med bare inbox_id, e-postadresse, visningsnavn, leverandør og tjenestemerke.

email_readread:emailsearch:email

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. Lange meldingskropper returneres i vinduer: sjekk body_truncated, og send body_next_offset tilbake som body_offset for å fortsette.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "list" (nylige meldingssammendrag), "read" (fullt innhold i én message_id), "read_batch" (flere message_ids), "search" (strukturerte filtre) eller "attachment" (last ned ett vedlegg som base64). Avgjør hvilke andre argumenter som gjelder.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen det skal leses fra. Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å oppdage inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`message_id`	string	valgfri	Leverandørens meldings-ID som skal leses (action 'read' eller 'attachment'), fra en tidligere list eller search.
`message_ids`	array[string]	valgfri	Leverandørens meldings-ID-er som skal leses (action 'read_batch'), fra en tidligere list eller search. Maks 50 per kall.
`folder`	string	valgfri	Mappe som skal listes (action 'list'). Standard "INBOX". Andre verdier: "SENT", "DRAFTS", "TRASH".
`unread_only`	boolean	valgfri	Returner kun uleste meldinger (action 'list'). Standard false.
`limit`	integer	valgfri	Maks antall resultater som returneres (action 'list' eller 'search'). Standard 20, maks 100.
`offset`	integer	valgfri	Nullbasert pagineringsforskyvning (action 'list' eller 'search'). Standard 0.
`include_html`	boolean	valgfri	Inkluder renset HTML-kropp (action 'read'/'read_batch'). Standard false.
`include_attachments`	boolean	valgfri	Inkluder base64-vedleggsdata (action 'read'/'read_batch'). På 'read_batch' deles 10 MB-grensen på tvers av hele kallet. Standard false.
`mark_as_read`	boolean	valgfri	Merk meldingen(e) som lest etter henting (action 'read'/'read_batch'). Standard false.
`from`	string	valgfri	Avsender som skal matches (action 'search'): e-postadresse, visningsnavn eller fragment (f.eks. "alice@example.com" eller "Alice").
`to`	string	valgfri	Primær (To) mottaker som skal matches (action 'search'): e-postadresse, visningsnavn eller fragment.
`cc`	string	valgfri	Kopimottaker (Cc) som skal matches (action 'search'): e-postadresse, visningsnavn eller fragment.
`subject`	string	valgfri	Tekst som skal matches i emnefeltet (action 'search'). Fraser med flere ord matches som de er.
`body`	string	valgfri	Fritekst å finne i meldingskroppen (action 'search'). (På Gmail matcher dette hele meldingen, ikke bare kroppen.)
`text`	string	valgfri	Fritekst å matche hvor som helst i meldingen: overskrifter og kropp (action 'search').
`unread`	boolean	valgfri	Action 'search': true = kun uleste meldinger; false = kun leste meldinger; utelat for begge.
`has_attachment`	boolean	valgfri	Action 'search': true = kun meldinger med vedlegg. Ikke støttet på generisk IMAP (ignoreres der).
`flagged`	boolean	valgfri	Action 'search': true = kun flaggede/stjernemerkede meldinger. Ikke støttet på Outlook/Graph (ignoreres der).
`since`	string (ISO date)	valgfri	ISO 8601-dato eller -datotid (action 'search'); returner meldinger mottatt på/etter (>=) dette tidspunktet. F.eks. "2026-06-01".
`before`	string (ISO date)	valgfri	ISO 8601-dato eller -datotid (action 'search'); returner meldinger mottatt strengt før (<) dette tidspunktet.
`query`	string	valgfri	Rå leverandørspesifikk spørrestreng (action 'search', nødløsning). Foretrekk de strukturerte feltene over. Kombineres med dem der det støttes; ignoreres på Fastmail.
`include_folders`	array	valgfri	Begrens et søk til disse mappenavnene (action 'search'). Standard: søk i alle mapper.

email_organizemanage:folders

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.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "move", "move_batch", "copy", "copy_batch", "flag", "archive" eller "search_and_move". Avgjør hvilke andre argumenter som gjelder og hvilket omfang som kreves.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen som eier meldingene. Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å hente tilgjengelige inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`message_id`	string	valgfri	Leverandørens meldings-ID for en enkeltmeldings-handling (move, copy, archive), fra en tidligere list, read eller search.
`message_ids`	array[string]	valgfri	Leverandørens meldings-ID-er for en bunke-handling (move_batch, copy_batch, flag). Maks 500 per kall.
`destination_folder_id`	string	valgfri	Målmappe (move, move_batch, copy, copy_batch, search_and_move): et kanonisk alias (inbox, sent, drafts, trash, archive, spam), et mappe-/etikettnavn (f.eks. 'Receipts') eller en leverandørspesifikk mappe-ID fra folder list-handlingen. Navn og alias løses automatisk.
`flag_action`	enum	valgfri	For action 'flag': endringen som skal anvendes på hver melding, enten "read" eller "unread" for å sette lesestatus, eller "flag"/"unflag" for å legge til eller fjerne et stjerne-/oppfølgingsflagg.
`from`	string	valgfri	Avsender som skal matches (search_and_move): e-postadresse, visningsnavn eller fragment.
`to`	string	valgfri	Primær (To) mottaker som skal matches (search_and_move): e-postadresse, visningsnavn eller fragment.
`cc`	string	valgfri	Kopimottaker (Cc) som skal matches (search_and_move): e-postadresse, visningsnavn eller fragment.
`subject`	string	valgfri	Tekst som skal matches i emnefeltet (search_and_move).
`body`	string	valgfri	Fritekst å finne i meldingskroppen (search_and_move). (På Gmail matcher dette hele meldingen.)
`text`	string	valgfri	Fritekst å matche hvor som helst i meldingen: overskrifter og kropp (search_and_move).
`unread`	boolean	valgfri	Søkehandlinger: true = kun uleste; false = kun leste; utelat for begge.
`has_attachment`	boolean	valgfri	Søkehandlinger: true = kun meldinger med vedlegg. Ikke støttet på generisk IMAP (ignoreres der).
`flagged`	boolean	valgfri	Søkehandlinger: true = kun flaggede/stjernemerkede meldinger. Ikke støttet på Outlook/Graph (ignoreres der).
`since`	string (ISO date)	valgfri	ISO 8601-dato eller -datotid (søkehandlinger); match meldinger mottatt på/etter (>=) dette tidspunktet.
`before`	string (ISO date)	valgfri	ISO 8601-dato eller -datotid (søkehandlinger); match meldinger mottatt strengt før (<) dette tidspunktet.
`query`	string	valgfri	Rå leverandørspesifikk spørrestreng (søkehandlinger, nødløsning). Foretrekk de strukturerte feltene over. Ignoreres på Fastmail.
`include_folders`	array	valgfri	Begrens søket til disse mappenavnene (søkehandlinger). Standard: alle mapper.
`limit`	integer	valgfri	For search_and_move: maks antall treff som skal behandles. Standard 500, maks 500.

email_deletedelete:email

Slett meldinger. Et 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, som 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.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "delete", "delete_batch" eller "search_and_delete". Avgjør hvilke andre argumenter som gjelder.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen som eier meldingene. Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å hente tilgjengelige inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`message_id`	string	valgfri	Leverandørens meldings-ID for en enkeltsletting (action 'delete'), fra en tidligere list, read eller search.
`message_ids`	array[string]	valgfri	Leverandørens meldings-ID-er for en bunke-sletting (action 'delete_batch'). Maks 500 per kall.
`permanent`	boolean	valgfri	Når true, slett hardt (forbi papirkurven; kan ikke angres); når false eller utelatt, flytt til papirkurven. Permanent sletting er tilgjengelig på IMAP og Fastmail; Gmail og Outlook støtter kun papirkurv. Standard false.
`from`	string	valgfri	Avsender som skal matches (search_and_delete): e-postadresse, visningsnavn eller fragment.
`to`	string	valgfri	Primær (To) mottaker som skal matches (search_and_delete): e-postadresse, visningsnavn eller fragment.
`cc`	string	valgfri	Kopimottaker (Cc) som skal matches (search_and_delete): e-postadresse, visningsnavn eller fragment.
`subject`	string	valgfri	Tekst som skal matches i emnefeltet (search_and_delete).
`body`	string	valgfri	Fritekst å finne i meldingskroppen (search_and_delete). (På Gmail matcher dette hele meldingen.)
`text`	string	valgfri	Fritekst å matche hvor som helst i meldingen: overskrifter og kropp (search_and_delete).
`unread`	boolean	valgfri	Søkehandling: true = kun uleste; false = kun leste; utelat for begge.
`has_attachment`	boolean	valgfri	Søkehandling: true = kun meldinger med vedlegg. Ikke støttet på generisk IMAP (ignoreres der).
`flagged`	boolean	valgfri	Søkehandling: true = kun flaggede/stjernemerkede meldinger. Ikke støttet på Outlook/Graph (ignoreres der).
`since`	string (ISO date)	valgfri	ISO 8601-dato eller -datotid (søkehandling); match meldinger mottatt på/etter (>=) dette tidspunktet.
`before`	string (ISO date)	valgfri	ISO 8601-dato eller -datotid (søkehandling); match meldinger mottatt strengt før (<) dette tidspunktet.
`query`	string	valgfri	Rå leverandørspesifikk spørrestreng (søkehandling, nødløsning). Foretrekk de strukturerte feltene over. Ignoreres på Fastmail.
`include_folders`	array	valgfri	Begrens søket til disse mappenavnene (søkehandling). Standard: alle mapper.
`limit`	integer	valgfri	For search_and_delete: maks antall treff som skal behandles. Standard 500, maks 500.

email_composesend:email

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.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "send", "reply" eller "forward". Avgjør hvilke andre argumenter som gjelder.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen det skal sendes fra. Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å hente tilgjengelige inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`message_id`	string	valgfri	Leverandørens meldings-ID for den opprinnelige meldingen (action 'reply' eller 'forward'), fra en tidligere list, read eller search.
`to`	array[string]	valgfri	Mottakernes e-postadresser (påkrevd for 'send' og 'forward'). Maks 50.
`subject`	string	valgfri	Emnefeltet for e-posten (action 'send'). Maks 998 tegn. Ved reply/forward avledes det fra originalen.
`body`	string	valgfri	Tekstkropp. For 'reply' er dette svaret ditt; for 'forward' et valgfritt notat som settes inn over den videresendte meldingen.
`cc`	array[string]	valgfri	CC-mottakere (send, forward). Standard [].
`bcc`	array[string]	valgfri	BCC-mottakere (send, forward). Standard [].
`html_body`	string	valgfri	HTML-versjon av kroppen (multipart/alternative). Den som kaller, er ansvarlig for trygg HTML.
`reply_to`	string	valgfri	Reply-To-overskriftsadresse (action 'send').
`reply_all`	boolean	valgfri	Svar til alle opprinnelige mottakere, både To og Cc (action 'reply'). Standard false.
`include_attachments`	boolean	valgfri	Legg ved den opprinnelige meldingens vedlegg på nytt (action 'forward'). Filer over 10 MB-budsjettet utelates. Standard false.
`include_signature`	boolean	valgfri	Om innboksens konfigurerte signatur skal legges til denne meldingen. Standard true; sett false for å sende denne ene meldingen uten signaturen.
`attachments`	array	valgfri	Filvedlegg. Hvert element: { filename, mime_type, data (base64) }. Maks 20 elementer, 10 MB totalt.
`idempotency_key`	string	valgfri	Valgfri ugjennomsiktig nøkkel (1–200 tegn) for én logisk utgående forespørsel. Gjenbruk den bare for å prøve nøyaktig samme handling og argumenter på nytt innen 24 timer; gjenbruk med andre argumenter avvises.

folderread:emailmanage:folders

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.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "list", "create", "rename" eller "delete". Avgjør hvilke andre argumenter som gjelder og hvilket omfang som kreves.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen hvis mapper skal administreres. Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å hente tilgjengelige inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`name`	string	valgfri	Navn på den nye mappen eller etiketten (action 'create'). 1–255 tegn.
`folder_id`	string	valgfri	Leverandørspesifikk mappe-/etikett-ID (action 'rename' eller 'delete'), fra folder list-handlingen.
`new_name`	string	valgfri	Nytt visningsnavn (action 'rename'). 1–255 tegn.

draftmanage:drafts

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.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "list", "create", "reply", "update" eller "send". Avgjør hvilke andre argumenter som gjelder.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen som eier utkastene. Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å hente tilgjengelige inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`draft_id`	string	valgfri	Leverandørens utkast-ID (action 'update' eller 'send'), fra den nyeste create-, update- eller list-handlingen. På IMAP-innbokser endres den etter hver oppdatering, så bruk alltid den nyeste.
`subject`	string	valgfri	Emnefeltet for utkastet (action 'create'/'update').
`body`	string	valgfri	Tekstkropp for utkastet (action 'create'/'update').
`to`	array[string]	valgfri	Mottakeradresser (action 'create'/'update'). Standard [].
`cc`	array[string]	valgfri	CC-mottakere (action 'create'/'update'). Standard [].
`bcc`	array[string]	valgfri	BCC-mottakere (action 'create'/'update'). Standard [].
`html_body`	string	valgfri	Valgfri HTML-kropp (action 'create'/'update').
`include_signature`	boolean	valgfri	Om innboksens konfigurerte signatur skal bygges inn i utkastet (action 'create'/'update'). Standard true; sett false for å lagre et utkast uten signaturen.
`idempotency_key`	string	valgfri	Valgfri ugjennomsiktig nøkkel (1–200 tegn) for én utkastsending. Gjenbruk den bare for å prøve nøyaktig samme sending på nytt innen 24 timer; gjenbruk med andre argumenter avvises.
`limit`	integer	valgfri	Maks antall utkast som returneres (action 'list'). Standard 20, maks 50.

scheduleschedule:email

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, men bare sendinger som fremdeles er 'pending' kan avbrytes). Utsenderen kjører hvert minutt, så levering kan skje opptil 60 sekunder etter send_at.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "create", "list" eller "cancel". Avgjør hvilke andre argumenter som gjelder.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen det skal sendes fra (action 'create') eller filtreres på (action 'list'). Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å hente tilgjengelige inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`to`	array[string]	valgfri	Mottakernes e-postadresser (action 'create'). Maks 50.
`subject`	string	valgfri	Emnefeltet for e-posten (action 'create'). Maks 998 tegn.
`body`	string	valgfri	Tekstkropp for e-posten (action 'create').
`send_at`	string (ISO 8601)	valgfri	ISO 8601-datotid med tidssone for når den skal sendes (action 'create'). Må være i fremtiden, f.eks. "2026-06-02T09:00:00Z".
`cc`	array[string]	valgfri	CC-mottakere (action 'create'). Standard [].
`bcc`	array[string]	valgfri	BCC-mottakere (action 'create'). Standard [].
`html_body`	string	valgfri	Valgfri HTML-versjon av kroppen (action 'create').
`reply_to`	string	valgfri	Valgfri Reply-To-overskriftsadresse (action 'create').
`attachments`	array	valgfri	Filvedlegg (action 'create'). Samme skjema som send-handlingen. Maks 20 elementer, 10 MB totalt.
`scheduled_send_id`	string (uuid)	valgfri	UUID for den planlagte sendingen som skal avbrytes (action 'cancel').
`idempotency_key`	string	valgfri	Valgfri ugjennomsiktig nøkkel for opprettelsen av én planlagt sending. Gjenbruk den bare for å prøve nøyaktig samme create-forespørsel på nytt innen 24 timer.
`limit`	integer	valgfri	Maks antall resultater (action 'list'). Standard 20, maks 100.

contact_searchmanage:contacts

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.

Parameter	Type	Påkrevd	Beskrivelse
`query`	string	påkrevd	Navn- eller e-postfragment, matchet ikke-skiller-mellom-store-og-små-bokstaver mot visningsnavn og adresse. Minst 1 tegn.
`inbox_id`	string (uuid)	valgfri	Valgfritt. Begrens sanntidsskanningen til én innboks. Utelat for å skanne innboksene nøkkelen har tilgang til (et begrenset antall).
`inbox`	string	valgfri	E-postadressen til innboksen det skal begrenses til, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`limit`	integer	valgfri	Maks antall kontakter som returneres. Standard 20, maks 50.

automationmanage:automations

Opprett og administrer planlagte triageregler som kjører uten tilsyn. En regel er et lagret søk pluss én fast handling, som evalueres på nytt med et fast intervall og uten noen modell i løkken: e-post matches, den tolkes aldri. Sett action: 'create' (name, filter, rule_action og interval_minutes; en regel opprettes alltid deaktivert), 'list', 'get', 'update', 'enable', 'disable', 'delete' (kjørehistorikken beholdes), 'runs' (tellere for nylige kjøringer) eller 'preview' (en tørrkjøring som viser hva filteret treffer akkurat nå, og som ikke utfører noe). Tilgjengelige regelhandlinger er move, label (en Gmail-etikett, en Outlook-kategori eller et IMAP-nøkkelord), mark_read, forward og draft_reply. Å slette e-post er ikke tilgjengelig for en automatisering. En videresending holdes alltid tilbake for menneskelig godkjenning uansett hva godkjenningsinnstillingen for postboksen sier, og draft_reply skriver bare et utkast. Forhåndsvis før du aktiverer. Alle handlinger krever manage:automations.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: «create», «list», «get», «update», «enable», «disable», «delete», «runs» eller «preview». Bestemmer hvilke andre argumenter som gjelder.
`automation_id`	string (uuid)	valgfri	UUID-en til regelen du vil handle på, slik 'create' eller 'list' returnerer den. Påkrevd for get, update, enable, disable, delete og runs. Valgfri for preview: send den inn for å tørrkjøre en lagret regel i stedet for et løst filter.
`inbox_id`	string (uuid)	valgfri	UUID-en til postboksen regelen overvåker ('create'), eller postboksen du vil forhåndsvise mot. Valgfri når nøkkelen har nøyaktig én postboks; ellers oppgir du denne eller inbox.
`inbox`	string	valgfri	E-postadressen til postboksen, som et enklere alternativ til inbox_id. Valgfri; ignoreres hvis inbox_id er oppgitt.
`name`	string	valgfri	Lesbart navn på regelen, 1 til 80 tegn. Påkrevd ved 'create'.
`filter`	object	valgfri	Det lagrede søket, med de samme strukturerte kriteriene som handlingen 'search' i email_read tar imot: from, to, cc, subject, body, text, unread, has_attachment, flagged, since, before. Minst ett kriterium kreves, fordi et tomt filter ville truffet hele postboksen din. Leverandørspesifikke råspørringer tas ikke imot her: en regel kjører uten tilsyn i månedsvis, og en råstreng er en dialekt ingenting validerer.
`rule_action`	object	valgfri	Den ene faste handlingen som brukes på hvert treff, som et merket objekt med type move (pluss folder), label (pluss label; skrives som en Gmail-etikett, en Outlook-kategori eller et IMAP-nøkkelord), mark_read, forward (pluss to og en valgfri note) eller draft_reply (pluss template). Den heter rule_action fordi action allerede velger operasjonen. Det finnes ingen slettehandling, og en slik forespørsel avvises i stedet for å bli ignorert. En videresending holdes alltid tilbake for godkjenning, og draft_reply skriver bare et utkast. En mal setter kun inn {{sender_name}}, {{sender_email}}, {{subject}} og {{date}}, alle HTML-escapet; alt annet er ren tekst, og meldingsinnhold interpoleres aldri.
`interval_minutes`	enum	valgfri	Minutter mellom kjøringer, fra den faste stigen 15, 30, 60, 180, 360, 720 eller 1440. Påkrevd ved 'create'. En stige i stedet for et fritt heltall, slik at en ettminutts regel ikke hamrer løs på leverandøren til den rategrensen.
`max_messages_per_run`	integer	valgfri	Hvor mange treff én kjøring kan handle på: 1 til 200, 25 som standard. Dette er skadeomfanget, og begrenser hvor mye e-post et feil filter kan røre før et menneske leser kjøreloggen.
`limit`	integer	valgfri	For handlingen 'runs': hvor mange kjøringer som skal returneres, nyeste først. Standard 20, maks 100.

signatureread:emailsend:email

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.

Parameter	Type	Påkrevd	Beskrivelse
`action`	enum	påkrevd	Hvilken operasjon som skal utføres: "get" (les gjeldende signatur) eller "set" (skriv den). Avgjør hvilke andre argumenter som gjelder og hvilket omfang som kreves.
`inbox_id`	string (uuid)	valgfri	UUID for innboksen hvis signatur skal leses eller settes. Valgfritt, løses automatisk når nøkkelen har nøyaktig én innboks; ellers oppgi denne eller inbox. Kall inbox_list for å hente tilgjengelige inbox-ID-er.
`inbox`	string	valgfri	E-postadressen til innboksen som skal brukes, som et vennlig alternativ til inbox_id. Valgfritt; ignoreres hvis inbox_id er oppgitt.
`signature_text`	string	valgfri	Tekstkropp for signaturen (action 'set'). Utelat for å la den være uendret; oppgi en tom streng for å fjerne den. Hvis bare tekst oppgis, avledes en HTML-versjon automatisk ved sending.
`signature_html`	string	valgfri	Valgfri rik HTML-kropp for signaturen (action 'set'). Støtter formatering (fet, kursiv, understreking, overskrifter, lister, farger, justering, lenker) og hostede bilder via <img>-tagger der src er en https-URL (ingen base64 eller CID); den saneres ved lagring. Utelat for å la den være uendret; oppgi en tom streng for å fjerne den.
`signature_enabled`	boolean	valgfri	Om signaturen legges til utgående e-post (action 'set'). Standard true; sett false for å slutte å legge den til uten å slette teksten.
`signature_reply_mode`	enum	valgfri	Når signaturen skal inkluderes ved svar og videresending (action 'set'): "always" (hvert svar/videresending), "first_only" (standard: bare den første meldingen i en tråd, for å unngå dobbel signering) eller "never".

Sikkerhetsmodell for automatiseringer

Hva en planlagt regel kan og ikke kan gjøre.

En automatisering rører postboksen din etter en plan, uten at noen ser på. Det er en annen risikokategori enn en agent du sitter og snakker med, så garantiene nedenfor håndheves av serveren i stedet for å overlates til regelen du skriver.

Ingen modell kjører uten tilsyn.

En regel er et lagret søk pluss én fast handling. Når den kjører, utfører serveren søket mot postboksen din og bruker handlingen på treffene. Ingenting leser e-posten din og bestemmer så hva som skal gjøres med den. E-postinnhold matches, det tolkes aldri som en instruksjon, og dermed er prompt-injeksjon strukturelt fraværende fra den ubetjente veien, ikke bare filtrert, poengsatt eller dempet. Det finnes ingenting i løkken som en injisert tekst kan snakke med.

Dette er verdt å si rett ut, for den farlige formen i denne kategorien er en agent som leser upålitelig innkommende e-post og deretter handler på den uten et menneske til stede. Offentlige hendelser, blant annet EchoLeak og den bakdørsinfiserte Postmark-MCP-serveren, har gjort kjøpere med rette skeptiske til nettopp det. I en interaktiv økt leser en modell faktisk e-posten din, som er hele poenget med produktet, og der er det et menneske til stede og innholdet er merket som upålitelige data. Den planlagte veien er den som kjører alene, og den inneholder ingen modell i det hele tatt.

Automatiseringer sletter aldri e-post.

Sletting er ikke en tilgjengelig handling, med hensikt. Flytte, merke med etikett, markere som lest, videresende og skrive et svarutkast er hele settet. Sletting er den ene handlingen en feilslått regel gjør irreversibel, så den er utelukket i valideringslaget, der en handling som bare nevner sletting avvises i stedet for å bli stilltiende ignorert.

Videresending venter alltid på et menneske.

En videresending fra en automatisering legges i godkjenningskøen og forlater postboksen din først når et medlem av arbeidsområdet godkjenner den, uansett hva innstillingen for sendegodkjenning på postboksen sier. Antall mottakere er begrenset per regel. En ubetjent regel kan ikke sende e-post ut av organisasjonen din på egen hånd.

Svarutkast blir alltid bare utkast.

En draft_reply-regel skriver et usendt utkast inn i den opprinnelige samtalen og stopper der. Ingenting sendes uten tilsyn, hos noen leverandør, under noen konfigurasjon.

Maler setter inn fire felt, og ikke noe mer.

En svarmal lagres ordrett og evalueres aldri. Bare {{sender_name}}, {{sender_email}}, {{subject}} og {{date}} settes inn, alle HTML-escapet. Meldingsinnhold interpoleres aldri, og det finnes ingen uttrykkssyntaks å evaluere, så ingenting som lander i postboksen din kan gjøre en mal om til en beregning.

Hver kjøring er dokumentert.

Hver kjøring registrerer hva filteret traff, hva som skjedde med hver melding og hva som ble lagt i godkjenningskø, sammen med tellere for treff, behandlet, vellykket, mislykket og hoppet over. Reversible handlinger tar vare på tilstanden som trengs for å angre dem. Kjørehistorikken lever lenger enn regelen den hører til, fordi den er dokumentasjonen på hva som ble gjort med postboksen din. Les den med handlingen 'runs' eller i dashbordet.

En regel har nøyaktig én nøkkels myndighet.

Hver regel kjører som API-nøkkelen som opprettet den. Den kan aldri overskride omfangene eller postbokstilgangen den nøkkelen allerede har, hver handling den utfører måles, rategrenses og skrives til revisjonsloggen akkurat som et interaktivt kall, og å tilbakekalle nøkkelen stopper regelen.

Gjentatte feil slår den av.

Etter 5 mislykkede kjøringer på rad deaktiveres regelen automatisk, og årsaken registreres. En regel som peker mot en postboks som har sluttet å svare, stopper i stedet for å prøve på nytt hvert 15. minutt i det uendelige.

Begrenset skadeomfang per kjøring.

Hver regel har et maksimalt antall meldinger én kjøring kan handle på, fra 1 til 200 og 25 som standard, slik at et filter som er bredere enn du mente, treffer høyst så mange meldinger før du ser kjøreloggen. En regel opprettes dessuten deaktivert, og forhåndsvisning er en tørrkjøring som viser hva filteret treffer akkurat nå, uten å utføre noe.

Feilkoder

Feilkoder og veiledning for nye forsøk.

Feil ved autentisering, omfang og hastighetsgrense returnerer et JSON-RPC error-objekt med en numerisk kode. Feil ved verktøykjøring (innboks ikke funnet, leverandørfeil, tak for rimelig bruk nådd osv.) returnerer et vanlig result med isError: true og en lesbar melding i content[0].text.

Kode	Type	Når den oppstår	Kan prøves på nytt
`-32001`	JSON-RPC error	Manglende, feilformatert, tilbakekalt eller utløpt API-nøkkel. Returneres også når API-nøkkelen mangler det nødvendige omfanget for verktøyet som kalles.	Nei
`-32601`	JSON-RPC error	Ukjent JSON-RPC-metode (f.eks. kall av en annen metode enn initialize, tools/list, tools/call)	Nei
`-32602`	JSON-RPC error	Ukjent verktøynavn, eller manglende / ugyldig parameter i tools/call	Nei
`-32003`	JSON-RPC error	Hastighetsgrense per nøkkel eller per arbeidsområde overskredet (HTTP 429). data.error_code er alltid "rate_limit_exceeded". Vent data.retry_after sekunder, eller les Retry-After-headeren, før du prøver på nytt.
`isError: true`	Tool result	Verktøyet ble kjørt, men støtte på en feil (innboks ikke funnet, melding ikke funnet, autentiseringsfeil hos leverandør, ugyldig mottaker, vedlegg for stort, leverandør 5xx). Feilbeskrivelsen finnes i content[0].text.	Nei
`isError: true`	Tool result	Arbeidsområdet har nådd taket for rimelig bruk av fakturerbare handlinger i inneværende faktureringsperiode. Det returneres som et vanlig verktøyresultat med isError: true, ikke som en JSON-RPC-feil, med detaljene under _meta["com.mcpemails/usage_limit"]: error_code "usage_limit_reached" og reset_at. Nye forsøk kan ikke lykkes før reset_at.	Nei

Eksempler på feilsvar

json

// Tool execution error: inbox not found
{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "Inbox not found or not accessible." }],
    "isError": true
  }
}

// Rate limit: JSON-RPC error object with data (HTTP 429). Safe to retry
// after retry_after seconds.
{
  "jsonrpc": "2.0",
  "id": 3,
  "error": {
    "code": -32003,
    "message": "Rate limit exceeded",
    "data": {
      "error_code": "rate_limit_exceeded",
      "window": "per_minute",
      "limit": 100,
      "used": 100,
      "retry_after": 34
    }
  }
}

// Fair-use ceiling: a normal tool result (HTTP 200) with isError: true.
// NOT a JSON-RPC error, and NOT retryable until reset_at.
{
  "jsonrpc": "2.0",
  "id": 4,
  "result": {
    "content": [{
      "type": "text",
      "text": "Usage limit reached for this workspace. Calls resume at reset_at."
    }],
    "isError": true,
    "_meta": {
      "com.mcpemails/usage_limit": {
        "error_code": "usage_limit_reached",
        "reset_at": "2026-09-01T00:00:00.000Z",
        "dashboard_url": "https://mcpemails.com/dashboard/usage"
      }
    }
  }
}

Hastighetsgrenser

Hastighetsgrenser og rimelig bruk.

Rullerende vinduer per nøkkel

100 req / min · 1 000 / t · 10 000 / dag

Håndheves per API-nøkkel uavhengig av plan. Ved overskridelse returnerer serveren HTTP 429 med JSON-RPC-feilkode -32003, data.error_code: "rate_limit_exceeded" og et data.retry_after-felt (sekunder). Respekter den verdien før du prøver på nytt: dette er en kort pause du kan prøve på nytt etter.

Plantak per minutt

Gratis 60 / min · Personal 120 / min · Pro 300 / min · Team 1 000 / min

En burst-grense for rimelig bruk per arbeidsområde, aggregert på tvers av alle API-nøklene dine. Ved overskridelse returnerer kall feilkode -32003 med data.error_code: "rate_limit_exceeded", data.window: "per_minute" og en data.retry_after-nedtelling (sekunder). Personal, Pro og Team hever taket.

Tak for rimelig bruk

Full stopp, ikke backoff

Hvert arbeidsområde har et tak for rimelig bruk av fakturerbare handlinger per faktureringsperiode. Det ligger langt over reell bruk og er ikke noe du kjøper deg forbi, men en agent som løper løpsk kan nå det. Å nå det er ikke en JSON-RPC-feil: kallet returnerer HTTP 200 med et vanlig verktøyresultat som bærer isError: true og en _meta["com.mcpemails/usage_limit"]-blokk med error_code: "usage_limit_reached" og reset_at. Det finnes ingen retry_after, fordi nye forsøk ikke kan lykkes før reset_at. Behandle det som full stopp, ikke som backoff.

Trygge nye forsøk

Respekter alltid retry_after; prøv aldri sendinger på nytt i blinde

For rate_limit_exceeded-feil, vent data.retry_after sekunder før du prøver på nytt. Bruk eksponentiell backoff for provider_error. Ikke prøv email_compose-sendinger automatisk på nytt ved provider_error, siden meldingen kan ha blitt akseptert av leverandøren allerede. Prøv aldri usage_limit_reached på nytt: den løsner først ved reset_at.

Klar til å koble til innboksen din?

Start på Gratis-planen: én tilkoblet innboks, for alltid og uten kort. Personal kobler til tre postkasser, Pro kobler til alle postkassene du eier, og Team legger til medlemmer, roller og et arbeidsområde per kunde.

Kom i gang gratis Se priser

Agenten din har en innbokspå fire steg.