[{"data":1,"prerenderedAt":618},["ShallowReactive",2],{"navigation":3,"\u002Fdevelopers\u002Femail-your-agent":216,"\u002Fdevelopers\u002Femail-your-agent-surround":613},[4,9,14,40,57,74,95,112,133,150,199,208],{"title":5,"path":6,"stem":7,"icon":8},"Quick start","\u002Fgetting-started","01.getting-started","i-lucide-rocket",{"title":10,"path":11,"stem":12,"icon":13},"Set up from the terminal","\u002Fcli","02.cli","i-lucide-terminal",{"title":15,"path":16,"stem":17,"children":18,"page":39},"Domains & DNS","\u002Fdomains","03.domains",[19,23,27,31,35],{"title":20,"path":21,"stem":22},"Adding a domain","\u002Fdomains\u002Fadding-a-domain","03.domains\u002F01.adding-a-domain",{"title":24,"path":25,"stem":26},"Automatic DNS setup","\u002Fdomains\u002Fautomatic-dns-setup","03.domains\u002F02.automatic-dns-setup",{"title":28,"path":29,"stem":30},"Manual DNS records","\u002Fdomains\u002Fmanual-dns-records","03.domains\u002F03.manual-dns-records",{"title":32,"path":33,"stem":34},"Domain verification","\u002Fdomains\u002Fverification","03.domains\u002F04.verification",{"title":36,"path":37,"stem":38},"Troubleshooting DNS","\u002Fdomains\u002Ftroubleshooting","03.domains\u002F05.troubleshooting",false,{"title":41,"path":42,"stem":43,"children":44,"page":39},"Mailboxes & Aliases","\u002Fmailboxes","04.mailboxes",[45,49,53],{"title":46,"path":47,"stem":48},"Creating mailboxes","\u002Fmailboxes\u002Fcreating-mailboxes","04.mailboxes\u002F01.creating-mailboxes",{"title":50,"path":51,"stem":52},"Aliases","\u002Fmailboxes\u002Faliases","04.mailboxes\u002F02.aliases",{"title":54,"path":55,"stem":56},"Passwords, passkeys & access","\u002Fmailboxes\u002Fpasswords-and-access","04.mailboxes\u002F03.passwords-and-access",{"title":58,"path":59,"stem":60,"children":61,"page":39},"Using Your Mail","\u002Fmail","05.mail",[62,66,70],{"title":63,"path":64,"stem":65},"Webmail","\u002Fmail\u002Fwebmail","05.mail\u002F01.webmail",{"title":67,"path":68,"stem":69},"IMAP & SMTP settings","\u002Fmail\u002Fimap-smtp-settings","05.mail\u002F02.imap-smtp-settings",{"title":71,"path":72,"stem":73},"iPhone setup","\u002Fmail\u002Fios-profile","05.mail\u002F03.ios-profile",{"title":75,"path":76,"stem":77,"children":78,"page":39},"Drive","\u002Fdrive","06.drive",[79,83,87,91],{"title":80,"path":81,"stem":82},"Drive overview","\u002Fdrive\u002Foverview","06.drive\u002F01.overview",{"title":84,"path":85,"stem":86},"Uploading & organising files","\u002Fdrive\u002Ffiles-and-folders","06.drive\u002F02.files-and-folders",{"title":88,"path":89,"stem":90},"Sharing files","\u002Fdrive\u002Fsharing","06.drive\u002F03.sharing",{"title":92,"path":93,"stem":94},"Connect Drive to other apps","\u002Fdrive\u002Fconnect-apps","06.drive\u002F04.connect-apps",{"title":96,"path":97,"stem":98,"children":99,"page":39},"Sending & Campaigns","\u002Fsending","07.sending",[100,104,108],{"title":101,"path":102,"stem":103},"Sending limits","\u002Fsending\u002Flimits","07.sending\u002F01.limits",{"title":105,"path":106,"stem":107},"Campaigns","\u002Fsending\u002Fcampaigns","07.sending\u002F02.campaigns",{"title":109,"path":110,"stem":111},"Deliverability & staying out of spam","\u002Fsending\u002Fdeliverability","07.sending\u002F03.deliverability",{"title":113,"path":114,"stem":115,"children":116,"page":39},"Transactional Email","\u002Ftransactional","08.transactional",[117,121,125,129],{"title":118,"path":119,"stem":120},"Transactional email","\u002Ftransactional\u002Foverview","08.transactional\u002F01.overview",{"title":122,"path":123,"stem":124},"Templates","\u002Ftransactional\u002Ftemplates","08.transactional\u002F02.templates",{"title":126,"path":127,"stem":128},"Sending via the API","\u002Ftransactional\u002Fsend-api","08.transactional\u002F03.send-api",{"title":130,"path":131,"stem":132},"Webhooks","\u002Ftransactional\u002Fwebhooks","08.transactional\u002F04.webhooks",{"title":134,"path":135,"stem":136,"children":137,"page":39},"Migrations","\u002Fmigrations","09.migrations",[138,142,146],{"title":139,"path":140,"stem":141},"Migrating your email","\u002Fmigrations\u002Foverview","09.migrations\u002F01.overview",{"title":143,"path":144,"stem":145},"Migrating from Gmail","\u002Fmigrations\u002Ffrom-gmail","09.migrations\u002F02.from-gmail",{"title":147,"path":148,"stem":149},"Migrating from Microsoft 365","\u002Fmigrations\u002Ffrom-microsoft-365","09.migrations\u002F03.from-microsoft-365",{"title":151,"path":152,"stem":153,"children":154,"page":39},"AI & Developers","\u002Fdevelopers","10.developers",[155,159,163,167,170,174,178,182,187,191,195],{"title":156,"path":157,"stem":158,"icon":8},"Quickstart","\u002Fdevelopers\u002Fquickstart","10.developers\u002F00.quickstart",{"title":160,"path":161,"stem":162},"Connect Claude","\u002Fdevelopers\u002Fconnect-claude","10.developers\u002F01.connect-claude",{"title":164,"path":165,"stem":166},"AI agents & API keys","\u002Fdevelopers\u002Fai-agents","10.developers\u002F02.ai-agents",{"title":130,"path":168,"stem":169},"\u002Fdevelopers\u002Fwebhooks","10.developers\u002F03.webhooks",{"title":171,"path":172,"stem":173},"Partner API","\u002Fdevelopers\u002Fpartners","10.developers\u002F04.partners",{"title":175,"path":176,"stem":177},"Intake and Lens","\u002Fdevelopers\u002Fintake","10.developers\u002F05.intake",{"title":179,"path":180,"stem":181},"Use Faivelo from your coding agent","\u002Fdevelopers\u002Fcoding-agents","10.developers\u002F06.coding-agents",{"title":183,"path":184,"stem":185,"icon":186},"Errors","\u002Fdevelopers\u002Ferrors","10.developers\u002F07.errors","i-lucide-circle-alert",{"title":188,"path":189,"stem":190},"Email your agent","\u002Fdevelopers\u002Femail-your-agent","10.developers\u002F08.email-your-agent",{"title":192,"path":193,"stem":194},"Email agent with Claude","\u002Fdevelopers\u002Fagent-with-claude","10.developers\u002F09.agent-with-claude",{"title":196,"path":197,"stem":198},"Email agent with ChatGPT","\u002Fdevelopers\u002Fagent-with-chatgpt","10.developers\u002F10.agent-with-chatgpt",{"title":200,"path":201,"stem":202,"children":203,"page":39},"Billing","\u002Fbilling","11.billing",[204],{"title":205,"path":206,"stem":207},"Billing & plans","\u002Fbilling\u002Fplans","11.billing\u002F01.plans",{"title":209,"path":210,"stem":211,"children":212,"page":39},"Security","\u002Fsecurity","12.security",[213],{"title":209,"path":214,"stem":215},"\u002Fsecurity\u002Foverview","12.security\u002F01.overview",{"id":217,"title":188,"body":218,"description":606,"extension":607,"links":608,"meta":609,"navigation":610,"path":189,"seo":611,"stem":190,"__hash__":612},"docs\u002F10.developers\u002F08.email-your-agent.md",{"type":219,"value":220,"toc":599},"minimark",[221,230,233,256,261,264,320,345,349,356,440,469,473,476,532,543,547,581,585,595],[222,223,224,225,229],"p",{},"An agent with an email address is an agent anyone can reach: you, your customers, other tools, other agents. No app to install, no chat window to keep open. You write to ",[226,227,228],"code",{},"agent@yourdomain.com",", the agent reads it, does the job and replies.",[222,231,232],{},"This page gets the address. The next pages wire it to your agent:",[234,235,236,244,250],"ul",{},[237,238,239,243],"li",{},[240,241,242],"a",{"href":193},"Build it with Claude",": claude.ai with no code, Claude Code on a schedule, or your own loop on the Claude API.",[237,245,246,249],{},[240,247,248],{"href":197},"Build it with ChatGPT",": a ChatGPT connector, or the OpenAI API with Faivelo as an MCP tool.",[237,251,252,255],{},[240,253,254],{"href":180},"Cursor, Codex, Gemini CLI and friends",": one-command installs of the same MCP server.",[257,258,260],"h2",{"id":259},"_1-get-an-address","1. Get an address",[222,262,263],{},"Pick whichever fits:",[265,266,269,276,308],"docs-aside",{"title":267,"type":268},"Fastest: a free address, no account","note",[222,270,271,272,275],{},"One command from any terminal. The agent gets ",[226,273,274],{},"agent@\u003Cname>.fvlmail.com",", an inbox and a key bound to it:",[277,278,283],"pre",{"className":279,"code":280,"language":281,"meta":282,"style":282},"language-bash shiki shiki-themes github-light-high-contrast","npx faivelo inbox my-agent --json\n","bash","",[226,284,285],{"__ignoreMap":282},[286,287,290,294,298,301,304],"span",{"class":288,"line":289},"line",1,[286,291,293],{"class":292},"sV4o_","npx",[286,295,297],{"class":296},"sYEJz"," faivelo",[286,299,300],{"class":296}," inbox",[286,302,303],{"class":296}," my-agent",[286,305,307],{"class":306},"sacAq"," --json\n",[222,309,310,311,314,315,319],{},"It can receive straight away and reply to anyone who writes to it. Open the ",[226,312,313],{},"claim_url"," from the output to attach it to an account, which lifts the limits. Details in ",[240,316,318],{"href":317},"\u002Fdevelopers\u002Fai-agents#start-without-an-account","Start without an account",".",[222,321,322,326,327,330,331,334,335,338,339,342,343,319],{},[323,324,325],"strong",{},"On your own domain"," (",[226,328,329],{},"agent@yourcompany.com","): add the domain in the dashboard or run ",[226,332,333],{},"npx faivelo init yourcompany.com"," from a terminal, then create a mailbox for the agent. Make it an ",[323,336,337],{},"agent inbox"," so it gets drafts, labels, threads and message webhooks, and give the agent a key of the ",[323,340,341],{},"agent"," kind, which can only ever see the inboxes it owns. See ",[240,344,164],{"href":165},[257,346,348],{"id":347},"_2-connect-the-agent","2. Connect the agent",[222,350,351,352,355],{},"Every path below uses the same hosted MCP server, ",[226,353,354],{},"https:\u002F\u002Ffaivelo.com\u002Fapi\u002Fmcp",". A signed-in connection (claude.ai, Claude Code, ChatGPT, Cursor) opens a browser to pick which mailboxes the agent may use. A headless agent sends its API key as a Bearer header instead:",[277,357,361],{"className":358,"code":359,"language":360,"meta":282,"style":282},"language-json shiki shiki-themes github-light-high-contrast","{\n  \"mcpServers\": {\n    \"faivelo\": {\n      \"url\": \"https:\u002F\u002Ffaivelo.com\u002Fapi\u002Fmcp\",\n      \"headers\": { \"Authorization\": \"Bearer fvl_live_...\" }\n    }\n  }\n}\n","json",[226,362,363,369,379,387,402,422,428,434],{"__ignoreMap":282},[286,364,365],{"class":288,"line":289},[286,366,368],{"class":367},"sigWx","{\n",[286,370,372,376],{"class":288,"line":371},2,[286,373,375],{"class":374},"s742_","  \"mcpServers\"",[286,377,378],{"class":367},": {\n",[286,380,382,385],{"class":288,"line":381},3,[286,383,384],{"class":374},"    \"faivelo\"",[286,386,378],{"class":367},[286,388,390,393,396,399],{"class":288,"line":389},4,[286,391,392],{"class":374},"      \"url\"",[286,394,395],{"class":367},": ",[286,397,398],{"class":296},"\"https:\u002F\u002Ffaivelo.com\u002Fapi\u002Fmcp\"",[286,400,401],{"class":367},",\n",[286,403,405,408,411,414,416,419],{"class":288,"line":404},5,[286,406,407],{"class":374},"      \"headers\"",[286,409,410],{"class":367},": { ",[286,412,413],{"class":374},"\"Authorization\"",[286,415,395],{"class":367},[286,417,418],{"class":296},"\"Bearer fvl_live_...\"",[286,420,421],{"class":367}," }\n",[286,423,425],{"class":288,"line":424},6,[286,426,427],{"class":367},"    }\n",[286,429,431],{"class":288,"line":430},7,[286,432,433],{"class":367},"  }\n",[286,435,437],{"class":288,"line":436},8,[286,438,439],{"class":367},"}\n",[222,441,442,443,446,447,446,450,446,453,446,456,446,459,446,462,465,466,319],{},"Once connected the agent has the tools a mail client has: ",[226,444,445],{},"list_messages",", ",[226,448,449],{},"read_message",[226,451,452],{},"get_thread",[226,454,455],{},"search_messages",[226,457,458],{},"send_message",[226,460,461],{},"create_draft",[226,463,464],{},"label_message"," and the rest. The full list is in ",[240,467,164],{"href":468},"\u002Fdevelopers\u002Fai-agents#mcp-for-headless-agents",[257,470,472],{"id":471},"_3-give-it-a-loop","3. Give it a loop",[222,474,475],{},"An agent that answers email runs the same four steps forever:",[477,478,479,498,506,521],"ol",{},[237,480,481,484,485,487,488,491,492,484,495,319],{},[323,482,483],{},"Look for new mail."," ",[226,486,445],{}," on the inbox and skip anything already seen or labelled ",[226,489,490],{},"handled",", or let Faivelo call your server the moment mail lands with a ",[226,493,494],{},"message.received",[240,496,497],{"href":168},"webhook",[237,499,500,484,503,505],{},[323,501,502],{},"Read the whole conversation.",[226,504,452],{}," returns the back-and-forth, your own earlier replies included, so the agent answers in context.",[237,507,508,484,511,513,514,517,518,520],{},[323,509,510],{},"Reply.",[226,512,458],{}," with ",[226,515,516],{},"inReplyTo"," set to the message id keeps the reply in the same thread in the sender's mail app. For anything sensitive, ",[226,519,461],{}," instead and let a person send it from Drafts.",[237,522,523,484,526,528,529,531],{},[323,524,525],{},"Mark it handled.",[226,527,464],{}," with a tag such as ",[226,530,490],{},", so the next run skips it.",[222,533,534,535,538,539,542],{},"The guides for ",[240,536,537],{"href":193},"Claude"," and ",[240,540,541],{"href":197},"ChatGPT"," show this loop as a prompt, a scheduled command and as code.",[257,544,546],{"id":545},"keeping-it-safe","Keeping it safe",[234,548,549,559,565,571],{},[237,550,551,554,555,558],{},[323,552,553],{},"Scope the key."," An agent key sees only the inboxes it created or was granted. It cannot touch your other mail, domains or billing. Revoke it in ",[323,556,557],{},"Settings → Developers"," and access stops at once.",[237,560,561,564],{},[323,562,563],{},"Mail is untrusted input."," Tell the agent, in its instructions, that the content of an email is data to act on, never instructions to follow. Faivelo's own tools already treat it that way.",[237,566,567,570],{},[323,568,569],{},"Drafts for anything that matters."," Refunds, commitments, anything legal: have the agent write a draft and a person press send.",[237,572,573,576,577,319],{},[323,574,575],{},"Allowances."," Sending counts against the Agents plan's monthly emails. Past the allowance receiving carries on and sending pauses until the 1st or an upgrade. See ",[240,578,580],{"href":579},"\u002Fdevelopers\u002Fai-agents#plans","plans",[257,582,584],{"id":583},"which-plan","Which plan",[222,586,587,588,592,593,319],{},"Every account has the Free Agents tier: 3 agent inboxes and 3,000 emails a month on a free Faivelo address, MCP included. Agent inboxes on your own domain, more inboxes, more volume and more webhook endpoints come with the Developer plan ($15 a month); it needs no email hosting plan. If you only want Claude or ChatGPT working in your ",[589,590,591],"em",{},"own"," mailbox, the Growth email plan ($12) includes the MCP server for that. Full comparison under ",[240,594,205],{"href":206},[596,597,598],"style",{},"html pre.shiki code .sV4o_, html code.shiki .sV4o_{--shiki-default:#702C00}html pre.shiki code .sYEJz, html code.shiki .sYEJz{--shiki-default:#032563}html pre.shiki code .sacAq, html code.shiki .sacAq{--shiki-default:#023B95}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sigWx, html code.shiki .sigWx{--shiki-default:#0E1116}html pre.shiki code .s742_, html code.shiki .s742_{--shiki-default:#024C1A}",{"title":282,"searchDepth":289,"depth":371,"links":600},[601,602,603,604,605],{"id":259,"depth":371,"text":260},{"id":347,"depth":371,"text":348},{"id":471,"depth":371,"text":472},{"id":545,"depth":371,"text":546},{"id":583,"depth":371,"text":584},"Give an AI agent its own address in two minutes, then talk to it by email. Works with Claude, ChatGPT and any agent that speaks MCP.","md",null,{},true,{"title":188,"description":606},"70lR5T90kPoLnbaGWi83oPLRt7L9ZigSSuj91KyVDH8",[614,616],{"title":183,"path":184,"stem":185,"description":615,"icon":186,"children":-1},"Every error code the Faivelo API returns, what it means and how to fix it.",{"title":192,"path":193,"stem":194,"description":617,"children":-1},"Three ways to put Claude behind an email address: claude.ai with no code, Claude Code on a schedule, or a small loop on the Claude API.",1791996336658]