Quickstart

Connect the hosted Instantly MCP server to your AI assistant and start managing your workspace through natural language.

Prerequisites

An Instantly workspace with an API v2 key.
An MCP-compatible AI assistant (Claude Desktop, Cursor, Windsurf, or any MCP client).

Get your API key

Open Settings > Integrations > API Keys and create an API v2 key. Select the scopes your workflows need.

Connect your MCP client

Choose your AI assistant and add the Instantly MCP server configuration.

Open Settings > Connectors > Add custom connector, then enter the server URL:

https://mcp.instantly.ai/mcp/YOUR_API_KEY

Replace YOUR_API_KEY with your Instantly API key. Claude Desktop connects to the remote server automatically.

Add the following to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "instantly": {
      "url": "https://mcp.instantly.ai/mcp/YOUR_API_KEY"
    }
  }
}

Replace YOUR_API_KEY with your Instantly API key.

Configure your MCP client with the hosted server URL and your API key in the Authorization header:

URL: https://mcp.instantly.ai/mcp
Header: Authorization: YOUR_API_KEY

If your client does not support custom headers, you can include the key in the URL path instead:

https://mcp.instantly.ai/mcp/YOUR_API_KEY

Keep your API key secure. Never share MCP configuration files that contain your key.

Test the connection

Open your AI assistant and ask it to list your email accounts:

“List all my email accounts in Instantly.”

If the connection is working, the assistant calls the list_accounts tool and returns your accounts.

Once connected, try these prompts with your AI assistant:

Browse the tools the MCP server exposes by category.

Learn about all supported authentication methods.

⌘I