Skip to main content
An AI agent can send email, and it can also own an inbox: receive each message by webhook, reply in the same thread, and keep a memory per conversation through the agent inbox and memory API. The MCP server (@nuntly/sdk-mcp) exposes all of it as tools for Claude Code, Cursor, VS Code, Codex, Gemini CLI and any client that speaks the Model Context Protocol. The TypeScript SDK (@nuntly/sdk) and the CLI (@nuntly/cli) cover the same API from code and from a shell.

Prerequisites

  • A Nuntly account. See account setup.
  • An API key. Pick Sending only for an agent that only sends, and Full access for an agent that manages domains, inboxes, webhooks or agent memory. See API keys.
  • Node.js 20 or later. To install it, take the current LTS release from nodejs.org. The MCP server runs with npx, which ships with Node.js.

Set up from a one-line prompt

Paste one of these lines into your agent, in the project you want to set up. Each points to an install guide written for an agent. The agent checks your environment and installs the package. It asks you to create the API key in the dashboard, sends a test email to your address, and ends with a setup report.
The migration guide finds the existing send calls of Resend, nodemailer, Postmark, SendGrid, Mailgun or Amazon SES and replaces them in place with the Nuntly SDK. It lists for you the calls it cannot map (provider templates, raw MIME, some SMTP clients), then runs your build. Every guide keeps the API key out of the conversation: you paste the key into your editor or terminal, and the agent never prints or commits it. The test email goes from hello@onboarding.nuntly.com to the address of the organization owner, so it works before you add a domain.

Set up by hand

Pick the page for your client. The Claude Code, Cursor, VS Code, Codex and Gemini CLI pages walk through the API key, the server configuration and a test email. The CLI and Vercel AI SDK pages cover the same API from a shell and from your own code.

Claude Code

Register the MCP server for a project, alone or for your team

Cursor

Install the MCP server with one click or by hand

VS Code

Add the MCP server to a Local or a Copilot session

Codex

Add the MCP server to your Codex config or read the key from your environment

Gemini CLI

Add the MCP server for your user or share it with your project

CLI

Give an agent shell commands with JSON output

Vercel AI SDK

Pass the MCP tools to a model from your own code

Troubleshooting

Fix a server that does not start or a tool that fails

What an agent can do, and what stays with you

An agent with a Full access key reaches the same operations as the dashboard through the API, the MCP server and the CLI, with the exceptions below. They stay with you because they involve your identity, your money, or access to your organization.

Next steps

AI agent inboxes

Receive messages by webhook, reply and keep a memory per thread

API keys

Choose between Sending only and Full access

SDKs

Install the TypeScript or Java SDK

Webhooks

Get notified of deliveries, bounces and inbound messages