Connect AI agents to DirectIQ with MCP

The Model Context Protocol (MCP) lets AI tools interact with DirectIQ programmatically. Manage contacts, organize lists and tags, check campaign results, and send transactional email — all from your favorite MCP-compatible client.

Get Started Free View on GitHub

Connection details

To connect your MCP client to DirectIQ, you need two things: the server URL and your API key.

Server URL

https://mcp.directiq.com/mcp

Authentication

Pass your API key in the x-api-key request header.

Finding your API key

Log in to your DirectIQ dashboard
Navigate to Settings → API Keys
Copy your existing API key or generate a new one

Docs on GitHub

The DirectIQ MCP server is hosted by DirectIQ, so there's nothing to install. Our GitHub repo has setup snippets for Cursor, VS Code, Claude Code, Claude Desktop, Windsurf, and Codex, a reference for every tool, security guidance, and troubleshooting tips.

github.com/directiq/mcp

Using Cursor? Add DirectIQ to Cursor in one click.

Configuration

Add the following configuration to your MCP client. This works with Claude Desktop, Cursor, VS Code, and any other MCP-compatible tool.

mcp-config.json

{
  "mcpServers": {
    "directiq": {
      "url": "https://mcp.directiq.com/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Setup steps

Copy the JSON configuration above
Replace YOUR_API_KEY with your actual API key from the DirectIQ dashboard
Add it to your MCP client's server configuration file
Restart your MCP client to connect

What you can do with MCP

Once connected, your AI agent can work with your DirectIQ account in plain language.

Manage contacts

Look up, add, update, and remove contacts, and get an account overview with contact counts, lists, tags, and confirmed senders.

Organize lists & tags

Create, rename, and clean up lists and tags, move contacts between lists, and tag or untag contacts, without opening the dashboard.

See campaign results

Ask how a campaign did and get recipients, opens, clicks, bounces, unsubscribes, and rates, plus who opened or clicked.

Send transactional email

Send one-to-one emails like confirmations and receipts from a confirmed sender address on your account.

Ready to connect your AI agent?

Sign up for DirectIQ, grab your API key, and start managing contacts, checking campaign results, and sending email through MCP in minutes.

Get Started Free View all integrations