> ## Documentation Index
> Fetch the complete documentation index at: https://nuntly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Nuntly from Cursor

> Install the Nuntly MCP server in Cursor with a one-click link or by hand in mcp.json, then send a test email from the Cursor agent to your address.

The Nuntly MCP server (`@nuntly/sdk-mcp`) gives the Cursor agent tools to send email, manage domains and webhooks, and read and reply to inbound messages. Check the [prerequisites](https://nuntly.com/docs/guides/ai-agents.md#prerequisites) first: an API key and Node.js 20 or later.

## Set up from a one-line prompt

Paste this line into the Cursor agent, in the project you want to set up. The agent follows an install guide written for it, asks you to create the API key, sends a test email to your address, and ends with a setup report.

```text theme={null}
Download https://nuntly.com/cursor/install.md raw (`curl -fsSL` on macOS and Linux, `curl.exe -fsSL` on Windows), read the whole output, and follow it word for word to connect Nuntly to this editor.
```

To set it up yourself, follow the steps below.

## Create an API key

In the dashboard, go to **API Keys** and create a key with the **Sending only** permission, and leave **Restrict to domains** empty. Copy it. Pick **Full access** instead for an agent that manages domains, inboxes, webhooks or agent memory. See [API keys](https://nuntly.com/docs/guides/api-keys.md).

## Add the MCP server

[Install in Cursor](https://cursor.com/install-mcp?name=nuntly\&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBudW50bHkvc2RrLW1jcEAyIl0sImVudiI6eyJOVU5UTFlfQVBJX0tFWSI6InlvdXItYXBpLWtleSJ9fQ%3D%3D). After the install, open **Customize** in the sidebar, edit the `nuntly` server, and replace `your-api-key` with your key. Save and close the file, then turn the server off and on with its toggle so that it starts with your key.

If the link does not open Cursor, add the server by hand:

```json ~/.cursor/mcp.json (%USERPROFILE%.cursor\mcp.json on Windows) theme={null}
{
  "mcpServers": {
    "nuntly": {
      "command": "npx",
      "args": ["-y", "@nuntly/sdk-mcp@2"],
      "env": {
        "NUNTLY_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Send a test email

Ask your agent: "Send a test email from [hello@onboarding.nuntly.com](mailto:hello@onboarding.nuntly.com) to my address." Use the email address of your Nuntly account (the organization owner), exactly as you signed up. This sender only delivers to that address.

## Troubleshooting

**The server does not start.** Open the Output panel and select **MCP Logs**. On native Windows, an error that names `npx` can mean that Cursor cannot start `npx` directly: set `"command": "cmd"` and `"args": ["/c", "npx", "-y", "@nuntly/sdk-mcp@2"]`.

For errors shared by every client, such as a tool that returns `isError: true`, see [Troubleshooting](https://nuntly.com/docs/guides/ai-agents-troubleshooting.md).

## Next steps

> [card] [AI agent inboxes](https://nuntly.com/docs/guides/receiving-agents.md)
>
> Give the agent its own inbox and a memory per thread

> [card] [What an agent can do](https://nuntly.com/docs/guides/ai-agents.md#what-an-agent-can-do-and-what-stays-with-you)
>
> See which operations stay with you


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.