Use Nuntly from VS Code

The Nuntly MCP server (@nuntly/sdk-mcp) gives the VS Code agent tools to send email, manage domains and webhooks, and read and reply to inbound messages. Check the prerequisites first: an API key and Node.js 20 or later.

Set up from a one-line prompt

Paste this line into the 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.

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.

Add the MCP server

For a Local session, install in VS Code. VS Code asks for your key when the server first starts (MCP: List Servers, then start nuntly) and stores it outside the configuration file. If the link does not open VS Code, add the server by hand:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "nuntly-api-key",
      "description": "Nuntly API key",
      "password": true
    }
  ],
  "servers": {
    "nuntly": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@nuntly/sdk-mcp@2"],
      "env": {
        "NUNTLY_API_KEY": "${input:nuntly-api-key}"
      }
    }
  }
}

{
  "mcpServers": {
    "nuntly": {
      "command": "npx",
      "args": ["-y", "@nuntly/sdk-mcp@2"],
      "env": {
        "NUNTLY_API_KEY": "your-api-key"
      }
    }
  }
}

The Local session file holds no key, so you can commit it and share the server with your team. A Copilot session reads the portable mcpServers format, and VS Code does not pass it a server that asks for an input. So in a Copilot session, put the entry in your user file ~/.copilot/mcp-config.json, outside the repository, and save and close it once your key is in.

Send a test email

Ask your agent: “Send a test email from 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. Run MCP: List Servers, select nuntly and open its output. On native Windows, an error that names npx can mean that VS Code 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.

Getting started

AI agents

Sending

Receiving

Broadcast

Configuration

Observability

Webhooks

Best practices

Libraries & tools

Frameworks

Use Nuntly from VS Code

Set up from a one-line prompt

Create an API key

Add the MCP server

Send a test email

Troubleshooting

Next steps

AI agent inboxes

What an agent can do

​Set up from a one-line prompt

​Create an API key

​Add the MCP server

​Send a test email

​Troubleshooting

​Next steps

AI agent inboxes

What an agent can do

Set up from a one-line prompt

Create an API key

Add the MCP server

Send a test email

Troubleshooting

Next steps