Use Faivelo from your coding agent

Your coding agent can set up email for the project it is building: put hello@ on the domain, wire the app's transactional email, and read replies. Two pieces make that work, and most tools take both in one command:

• The MCP server at https://faivelo.com/api/mcp lets the agent read, search, send and organise mail, create mailboxes and edit DNS. It signs in through your browser the first time, and you tick which mailboxes it may use.
• The faivelo-email skill teaches the agent the setup path (npx faivelo init), the send API, the SDKs and how to verify webhooks, so it writes working code the first time.

The MCP server is included from the Growth plan and in the free trial. The skill and the CLI work on any plan.

Claude Code

Plugin with both the MCP server and the skill:

/plugin marketplace add ethannschwartz/faivelo-mcp
/plugin install faivelo@faivelo

MCP server only:

claude mcp add --transport http faivelo https://faivelo.com/api/mcp

More on what Claude can do once connected: Connect Claude.

Cursor

Or add it to .cursor/mcp.json (this project) or ~/.cursor/mcp.json (every project):

{ "mcpServers": { "faivelo": { "url": "https://faivelo.com/api/mcp" } } }

VS Code

Install in VS Code, or from a terminal:

code --add-mcp '{"name":"faivelo","type":"http","url":"https://faivelo.com/api/mcp"}'

OpenAI Codex

codex mcp add faivelo --url https://faivelo.com/api/mcp
codex mcp login faivelo

Gemini CLI

Extension with the MCP server and the skill:

gemini extensions install https://github.com/ethannschwartz/faivelo-mcp

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json. Windsurf calls the field serverUrl:

{ "mcpServers": { "faivelo": { "serverUrl": "https://faivelo.com/api/mcp" } } }

Any agent that reads Agent Skills

npx skills add ethannschwartz/faivelo-mcp

Installs the faivelo-email skill for whichever agents you have (Claude Code, Codex, Cursor, OpenCode and others).

Agents with no browser

Servers, CI and long-running agents can't click through a sign-in. Give them an agent key instead: create one in Settings → Developers with kind agent, and send it as a header.

{
  "mcpServers": {
    "faivelo": {
      "url": "https://faivelo.com/api/mcp",
      "headers": { "Authorization": "Bearer fvl_live_..." }
    }
  }
}

An agent key only reaches the mailboxes it created or was granted. It can't read your other inboxes, change domains or billing, or make more keys. See AI agents & API keys.

SDKs

npm install faivelo     # Node.js and TypeScript
pip install faivelo     # Python

When the agent finishes

Ask it to call get_setup_summary. It returns a short summary of what is set up, what is still waiting on DNS, and where to manage it, ready to paste into a README or send to a teammate.