Kall MCP-serveren for e-post
rett fra curl eller et skript
Ingen klient, ingen SDK. Ett Streamable HTTP-endepunkt som snakker JSON-RPC 2.0, autentisert med en avgrenset bearer-nøkkel du kan tilbakekalle med ett klikk.
Send JSON-RPC 2.0 med POST til https://mcpemails.com/api/mcp med en Authorization Bearer-header som inneholder en API-nøkkel fra dashbordet ditt. Støttede metoder er initialize, tools/list, tools/call, prompts/list og prompts/get.
Slik kobler et skript eller en rå HTTP-klient seg til: en avgrenset API-nøkkel
Et skript eller en rå HTTP-klient kjører ikke OAuth-flyten i nettleseren mot en ekstern MCP-server, så den autentiserer med et bearer-token i stedet. Opprett en API-nøkkel i dashbordet, kryss av bare for tilgangene (scopes) agenten trenger, og send den fra skriptet eller HTTP-klienten som en Authorization: Bearer-header. Tilkoblinger med nøkkel og med OAuth treffer det samme endepunktet og får den samme verktøykatalogen; forskjellen er bare hvordan tokenet skaffes.
Den ene verdien du trenger
Alt på denne siden er måter å få denne URL-en inn i curl and the raw API på.
| Felt | Verdi |
|---|---|
| MCP-serverens URL | https://mcpemails.com/api/mcp |
| Transport | Streamable HTTP (MCP 2025-06-18) |
| Autentisering | Authorization: Bearer, med en avgrenset API-nøkkel fra dashbordet ditt. |
Slik kobler du curl and the raw API til innboksen din
Fire steg. De to første er like for alle klienter, resten gjelder bare denne.
Opprett en gratis konto og koble til en postkasse
Registrer deg på mcpemails.com, uten kort, og gå til Dashboard, Inboxes, Connect Inbox. Outlook og Microsoft 365 kobles til med Microsoft-innlogging; Gmail, iCloud, Fastmail, Yahoo, Zoho og Yandex krever et app-spesifikt passord; alt annet kobles til over vanlig IMAP og SMTP. Gratisplanen gir deg én innboks, for alltid.
Opprett en avgrenset API-nøkkel
I Dashboard, API Keys klikker du Create key. Gi den et navn og kryss av bare for tilgangene denne agenten trenger: read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email og manage:automations. Nøkkelen ser ut som mcpe_ etterfulgt av 64 heksadesimale tegn og vises bare én gang, så kopier den før du lukker dialogen.
Kall endepunktet
Send en JSON-RPC 2.0-body med POST til https://mcpemails.com/api/mcp med nøkkelen i Authorization-headeren. Start med tools/list for å se katalogen, og deretter inbox_list for å finne ID-ene til postkassene dine.
Håndter svaret
Resultatene kommer tilbake som JSON-RPC 2.0. Vellykkede resultater har også et typet structuredContent-objekt, så et skript slipper å tolke fritekst.
curl -X POST https://mcpemails.com/api/mcp \
-H "Authorization: Bearer mcpe_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Lurer du på hvilken postkasse du bør koble til først? Se kompatibilitetsoversikten for leverandører
Dette snubler folk i med curl
Send nøkkelen i headeren, ikke i spørrestrengen
En nøkkel i ?key= eller ?api_key= godtas fortsatt for integrasjoner som er eldre enn headeren, men den bør ikke brukes i noe nytt. Legitimasjon i URL-er blir liggende i nettleserhistorikk, proxylogger, referrer-headere og overvåkingssystemer, som du ikke har kontroll over. Authorization-headeren er den støttede veien.
Utgående kall tar en idempotensnøkkel, og nye forsøk uten en er en reell risiko
Sending, svar, videresending, sending av utkast og planlagt sending godtar en valgfri idempotensnøkkel, som respekteres i 24 timer. Et nettverkstidsavbrudd under en sending er tvetydig av natur: e-posten kan godt ha gått. Med en idempotensnøkkel er et nytt forsøk trygt. Uten en er et nytt forsøk en ny e-post.
Lange operasjoner tar faktisk lang tid
Et søk-og-flytt i en stor postkasse har i produksjon blitt målt til rundt 152 sekunder, og proxyen tillater opptil 270 sekunder før den gir opp av seg selv. Sett et tidsavbrudd i klienten som tar høyde for det, i stedet for de vanlige få sekundene, ellers avbryter du operasjoner som var i ferd med å lykkes.
Det finnes ingen push, i noen retning
Ingen webhooks, ingen hendelser startet av serveren, ingen callback-URL å registrere. Å reagere på ny e-post betyr polling, for eksempel email_read med action: "list" og bare uleste, med det intervallet arbeidsflyten din trenger. Grensene er 100 per minutt, 1 000 per time og 10 000 per døgn per nøkkel.
Begrensninger verdt å vite om
- Forespørsler er begrenset til 100 per minutt, 1 000 per time og 10 000 per døgn per nøkkel, i tillegg til planens tak for fakturerbare handlinger.
- Serveren er rent forespørsel og svar. Det finnes ingen webhooks og ingen hendelser startet av serveren, så ny e-post vekker aldri agenten din av seg selv. Vil du reagere på innkommende e-post, må du polle etter en tidsplan.
- E-post hentes direkte fra leverandøren ved hvert kall og lagres aldri. Bare det krypterte OAuth-tokenet eller app-passordet beholdes, så et tilbakekalt token eller et endret passord for postkassen stopper tilgangen umiddelbart.
curl and the raw API og e-post, besvart
Kan jeg bruke dette uten en MCP-klient?
Ja. Det er et vanlig HTTPS-endepunkt som snakker JSON-RPC 2.0, så curl, en cron-jobb, en backend-tjeneste eller et hvilket som helst HTTP-bibliotek kan kalle det. Autentiser med en bearer-API-nøkkel fra Dashboard, API Keys. Verktøykatalogen er identisk med den en MCP-klient ser.
Hvilke JSON-RPC-metoder støttes?
initialize, tools/list, tools/call, prompts/list og prompts/get. Vellykkede resultater har et typet structuredContent-objekt ved siden av det menneskelesbare innholdet, og det er det et skript bør lese.
Hvordan gjør jeg nye forsøk trygge?
Send med en idempotensnøkkel på utgående operasjoner. Sending, svar, videresending, sending av utkast og planlagt sending godtar en og respekterer den i 24 timer, så å prøve den samme forespørselen på nytt etter et tidsavbrudd kan ikke gi en ny e-post. Lesing er naturlig trygt å prøve på nytt.
Hva er grensene for antall forespørsler?
100 forespørsler per minutt, 1 000 per time og 10 000 per døgn per nøkkel, i tillegg til planens tak for fakturerbare handlinger. Mislykkede kall og inbox_list faktureres ikke.
Lagres e-posten min på serverne deres?
Nei. Hver melding hentes direkte fra leverandøren din for forespørselen som ba om den, og sendes rett videre til klienten din. Bare det krypterte OAuth-tokenet eller app-passordet beholdes, slik at fremtidige kall kan autentiseres. Sletter du innboksen i dashbordet, eller tilbakekaller tilgangen hos leverandøren, avsluttes tilkoblingen med en gang.
Automatiser innboksen med skript
Ett endepunkt, én avgrenset nøkkel. Én innboks gratis for alltid, uten kort.