# Use Faivelo from your coding agent

> One-command installs of the Faivelo MCP server and email skill for Claude Code, Cursor, Codex, VS Code, Gemini CLI, Windsurf and OpenClaw.

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:

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

MCP server only:

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

More on what Claude can do once connected: [Connect Claude](/developers/connect-claude).

## Cursor

[![Add Faivelo to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=faivelo&config=eyJ1cmwiOiJodHRwczovL2ZhaXZlbG8uY29tL2FwaS9tY3AifQ%3D%3D)

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

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

## VS Code

[Install in VS Code](https://insiders.vscode.dev/redirect/mcp/install?name=faivelo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ffaivelo.com%2Fapi%2Fmcp%22%7D), or from a terminal:

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

## OpenAI Codex

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

## Gemini CLI

Extension with the MCP server and the skill:

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

## Windsurf

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

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

## Any agent that reads Agent Skills

```bash
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](https://faivelo.com/settings/developers) with kind *agent*, and send it as a header.

```json
{
  "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](/developers/ai-agents).

## SDKs

```bash
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.