DirectIQ

DirectIQ MCP Server

Connect Claude, ChatGPT, Cursor, VS Code, Windsurf, and any other Model Context Protocol client to your DirectIQ account. Manage contacts, lists, and tags, get an account overview, and send transactional email in plain language.

DirectIQ is an email marketing and transactional email platform for small businesses, with fast human support and pay-as-you-go pricing. → directiq.com

• Endpoint: https://mcp.directiq.com/mcp
• Transport: Streamable HTTP (remote, hosted by DirectIQ, nothing to install)
• Auth: DirectIQ API key in the x-api-key header, or Authorization: Bearer <key> (OAuth coming soon)
• Server card: https://mcp.directiq.com/.well-known/mcp/server-card.json
• Registry name: com.directiq.mcp/directiq

This repository holds the public documentation, registry metadata, and client configuration for the hosted DirectIQ MCP server at mcp.directiq.com, operated by DirectIQ. There is nothing to install or build.

Quick start

1. Get an API key: log in to the DirectIQ dashboard, then go to Settings → API Keys and copy or generate a key. No account yet? Sign up free.
2. Add the server to your client: see the snippets below.
3. Try a prompt: "Give me an overview of my DirectIQ account."

Client setup

Cursor

Add to Cursor. This link opens Cursor with the config filled in. Replace YOUR_DIRECTIQ_API_KEY with your key.

Or add it manually to ~/.cursor/mcp.json:

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

VS Code (GitHub Copilot)

Add to .vscode/mcp.json. VS Code prompts for the key and stores it securely:

{
  "inputs": [
    { "type": "promptString", "id": "directiq_api_key", "description": "DirectIQ API key", "password": true }
  ],
  "servers": {
    "directiq": {
      "type": "http",
      "url": "https://mcp.directiq.com/mcp",
      "headers": { "x-api-key": "${input:directiq_api_key}" }
    }
  }
}

Claude Code

claude mcp add --transport http directiq https://mcp.directiq.com/mcp --header "x-api-key: YOUR_DIRECTIQ_API_KEY"

Claude Desktop

Until OAuth ships, use the mcp-remote bridge in claude_desktop_config.json:

{
  "mcpServers": {
    "directiq": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.directiq.com/mcp", "--header", "x-api-key:${DIRECTIQ_API_KEY}"],
      "env": { "DIRECTIQ_API_KEY": "YOUR_DIRECTIQ_API_KEY" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

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

OpenAI Codex

~/.codex/config.toml, after setting export DIRECTIQ_API_KEY=...:

[mcp_servers.directiq]
url = "https://mcp.directiq.com/mcp"
env_http_headers = { "x-api-key" = "DIRECTIQ_API_KEY" }

Any other MCP client

Tools

Every tool declares MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) so your client can ask for confirmation before changes. Full API schemas: https://rest.directiq.com/{core|contacts|subscription}/swagger/index.html.

Documentation

• Client setup
• Tool reference: every tool with its inputs and annotations
• Authentication and security
• Troubleshooting
• Instructions for AI installers (Cline)

Example prompts

• "Give me an overview of my DirectIQ account: contacts, lists, tags, and confirmed senders."
• "How many contacts do I have, and how many are disabled?"
• "Create a list called 'Fall Promo 2026' and a tag called 'vip'."
• "Show me contact 12345 and change their first name to Jamie."
• "Send a transactional email from hello@mybusiness.com to me@mybusiness.com with the subject 'Order confirmed' and a short thank-you message."
• "What DirectIQ API endpoints are available for subscriptions?"

Security and data handling

• Your API key is sent only as the x-api-key header over HTTPS to mcp.directiq.com. Never paste it into chat or commit it to a repository.
• The server acts with the permissions of the API key's DirectIQ account. Revoke or rotate keys anytime in Settings → API Keys.
• Emails can only be sent from confirmed sender addresses on your account.
• directiq_write_request and directiq_update_contact can change or delete data. Keep your client's tool-approval prompts on.
• Privacy policy: https://www.directiq.com/privacy-policy · Terms: https://www.directiq.com/terms-of-service

Pricing

The MCP server is free to use. Emails sent through it count toward your normal DirectIQ plan, including pay-as-you-go. See directiq.com/pricing.

Support

• Help center: https://help.directiq.com
• Email: support@directiq.com
• Setup guide: https://www.directiq.com/mcp-setup/
• Issues with this repo or listing: GitHub Issues

Changelog

See CHANGELOG.md.

License

The documentation and configuration in this repository are licensed under the MIT License. The DirectIQ service itself is governed by the DirectIQ Terms of Service.