Cursor Setup

Connect Cursor to Keplars in under two minutes using the MCP Server. Send emails and manage contacts from inside your editor.

Cursor supports MCP servers natively in Agent mode. Once configured, you can send emails, manage audiences, and trigger campaigns without leaving your editor.

Setup

Get your Keplars API keys

Open the Keplars dashboard and navigate to API Keys in your workspace settings. You need two keys:

Send key (prefixed live_): used for sending emails
Admin key (prefixed adm_): used for templates, contacts, campaigns, and domains

Create both and copy them. You will only see each key once.

Install mcp-remote

npm install -g mcp-remote

Open Cursor MCP settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows) and search for Open MCP Settings. This opens ~/.cursor/mcp.json.

If the file does not exist, create it at that path.

Add the Keplars server

{
  "mcpServers": {
    "keplars": {
      "command": "mcp-remote",
      "args": [
        "https://mcp.keplars.com/mcp",
        "--header",
        "Authorization:<YOUR_SEND_KEY>",
        "--header",
        "X-Admin-Api-Key:<YOUR_ADMIN_KEY>"
      ]
    }
  }
}

If you already have other MCP servers in the config, add keplars alongside them inside mcpServers.

Restart Cursor

Close and reopen Cursor. The Keplars tools load on startup.

Verify the connection

Switch to Agent mode in the Cursor chat panel and click the tools icon. You should see the Keplars tools listed, including send_transactional_email, list_audiences, and the rest.

Try it out

Once connected, ask Cursor Agent naturally:

Send a transactional email

"Send a transactional email to [email protected] with subject 'Deployment complete' and body 'Your app was deployed successfully'"

List templates and send one

"List my Keplars templates, then send the welcome template to [email protected] with first_name set to Sarah"

Create and send a campaign

"Create a Keplars campaign called 'Release Notes' targeting audience aud-123 using template tmpl-abc with subject 'What is new in v2.0', then send it"

Campaigns and bulk sends trigger a confirmation step

When you ask Cursor to send a campaign or a bulk email, it will first show you the audience size and ask you to confirm before dispatching. Reply "yes" to proceed or "no" to cancel.

Troubleshooting

Tools not appearing in Agent mode

MCP tools only appear in Agent mode, not in normal chat or Ask mode. Make sure you have Agent selected in the chat panel dropdown.

Tools not appearing after restart

Check that the JSON in ~/.cursor/mcp.json is valid. Use jsonlint.com to validate. A trailing comma or missing brace will prevent the config from loading silently.

mcp-remote not found

Run npm install -g mcp-remote and make sure the npm global bin directory is in your PATH. Restart your terminal after installing.

"Unauthorized" error on email sends

Your send key (live_ prefix) may be invalid or deleted. Generate a new one from the Keplars dashboard under API Keys and update the Authorization value in your config.

"Unauthorized" error on templates, contacts, or campaigns

These tools require the admin key (adm_ prefix) in X-Admin-Api-Key. Make sure both headers are present in your config.

Cursor Setup

On this page