DirectIQ
Overview
Description from the maker (original English)
Manage DirectIQ contacts, lists and tags, see campaign results, and send transactional email.
PopNx MCP’s three pillars
These three are never merged into one score: opinions, measurements and popularity are different things.
- User voiceiNo reviews yetReviews open together with accounts in a later step
- Our basic checksi3 of 3 passedChecked from public information; code not scanned yet
- UsageiVery new★ –
What you can do with it
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
- Connection: Runs in the cloud
- Transport: Streamable HTTP
- Category: Marketing & social media
- You need to fill in: x-api-key
Install
Pick the AI app you use, then copy the settings.
Before you install
- Basic checks: 3 of 3 passed
- Runs on the maker’s server: what you ask it goes through their server.
- Can do 30 things (tools) directiq_account_overview, directiq_get_contact, directiq_list_contacts, directiq_contact_count …
- You fill in yourself:
x-api-key
Values marked secret are keys to your account. Never share them or paste them into a chat.
You need
- Runs in the cloudNothing to install; it connects over the internet
Which app do you use?
Pick your app above. We remember it, so next time the button says “Install in …”.
This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.
Run this in your terminal
claude mcp add --transport http directiq https://mcp.directiq.com/mcp --header 'x-api-key: your-value'Fill in the empty values before running it.
Or copy the settings yourself
Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json
{
"mcpServers": {
"directiq": {
"url": "https://mcp.directiq.com/mcp",
"headers": {
"x-api-key": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
Or copy the settings yourself
Paste into .vscode/mcp.json in your project
{
"servers": {
"directiq": {
"type": "http",
"url": "https://mcp.directiq.com/mcp",
"headers": {
"x-api-key": "your-value"
}
}
}
}Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.
This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.
Your choice stays on this device in a cookie; no account needed.
Values you fill in
x-api-keysecret required HTTP headerDirectIQ API key (Dashboard > Settings > API Keys)
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
What it can do
Tool names and descriptions exactly as the server reported them on Nov 7, 2026. The maker wrote them, not us; we show them as plain text.
directiq_account_overviewSummarize the account in one call: total contacts, active/disabled status counts, list count, tag count, and confirmed sender addresses. A good first call in a conversation, and the way to find a valid "from" address for directiq_send_email. Each section that fails to load is ret
directiq_get_contactGet one contact by numeric ID: email, first and last name, status, created and updated dates, tags, lists, and notes. Use when you already have the ID; to find a contact, page through directiq_list_contacts. Returns an error if no contact has that ID.
directiq_list_contactsList contacts one page at a time, oldest first, with each contact's ID, email, name, status, tags, and lists. Returns { pageNumber, totalCount, result, hasNextPage }; request the next pageNumber while hasNextPage is true. Use to browse contacts or find an ID. For just the total,
directiq_contact_countReturn the total number of contacts in the account as a single number. Use for a quick count; for counts plus active/disabled status, lists, tags, and senders, use directiq_account_overview.
directiq_upsert_contactAdd a contact to a list, creating the contact if the email is new or updating its name if it already exists. Optionally applies tags (created if missing). Use this to create contacts; to change other fields on an existing contact, use directiq_update_contact. Returns import count
directiq_update_contactUpdate fields on an existing contact by ID, such as firstName, lastName, or email. Only the fields you pass change, and they overwrite the current values. To create a contact, use directiq_upsert_contact; to change list or tag membership, use the list and tag tools.
directiq_delete_contactPermanently delete a contact by ID, removing it from every list and tag. This cannot be undone. Confirm with the user first; to only take a contact off one list, use directiq_remove_contact_from_list.
directiq_list_listsList every contact list in the account with its ID and name. Use to find a list ID before adding contacts, sending campaigns, or calling directiq_get_list.
directiq_get_listGet one contact list by ID: name, created and modified dates, and total, active, and disabled contact counts. Use directiq_list_lists to find the ID. Returns an error if no list has that ID.
directiq_create_listCreate a new, empty contact list and return it with its new ID. Calling it twice creates two lists with the same name, so check directiq_list_lists first. Add contacts afterwards with directiq_upsert_contact or directiq_add_contact_to_list.
directiq_rename_listRename a contact list by ID. Its contacts are unchanged; the previous name is overwritten.
directiq_delete_listPermanently delete a contact list by ID. The contacts themselves are kept, but their membership in this list is lost. This cannot be undone; confirm with the user first.
directiq_add_contact_to_listAdd an existing contact (by contact ID) to a list. Adding a contact that is already on the list has no effect. To add someone by email who may not exist yet, use directiq_upsert_contact.
directiq_remove_contact_from_listRemove a contact from one list. The contact stays in the account and on its other lists; to delete the contact entirely, use directiq_delete_contact.
directiq_list_segmentsList saved segments (rule-based groups of contacts) with their IDs and names. Returns an empty array if the account has none. Segments are managed in the DirectIQ dashboard.
directiq_list_tagsList every tag in the account with its ID and name. Use to check whether a tag exists or to find its ID before renaming or deleting it.
directiq_get_tagGet one tag by ID with its name and details. Use directiq_list_tags to find the ID. Returns an error if no tag has that ID.
directiq_create_tagCreate a new tag and return it with its ID. Check directiq_list_tags first to avoid duplicates. To tag a contact, use directiq_tag_contact, which also creates missing tags.
directiq_rename_tagRename a tag by ID. Contacts keep the tag under its new name; the previous name is overwritten.
directiq_delete_tagPermanently delete a tag by ID and remove it from every contact. Contacts are kept. This cannot be undone; confirm with the user first.
directiq_tag_contactApply one or more tags to a contact by contact ID. Tags that do not exist yet are created. Applying a tag the contact already has has no effect.
directiq_untag_contactRemove a tag from a contact, identified by the contact email and the tag name. The tag itself and the contact are kept; to delete the tag everywhere, use directiq_delete_tag.
directiq_list_campaignsList email campaigns and automation flows with ID, name, type (Regular or Flow), status, subject, sender, target lists, recipient count, and scheduled send time. Returns { campaigns, nextPageToken }; pass nextPageToken back to get the next page (null means no more). Use the IDs w
directiq_get_campaignGet one campaign by ID: name, type, status, subject, sender, target lists and segments, template ID, recipient count, and scheduled send time. For opens, clicks, and other results, use directiq_campaign_stats.
directiq_campaign_statsSummarize how a campaign performed: counts of recipients, opens, clicks, bounces, unsubscribes, and complaints, plus open, click, bounce, and unsubscribe rates as percentages of recipients. Use directiq_campaign_report to see which contacts did what. A section that fails to load
directiq_campaign_reportList the contacts behind one campaign result, one page at a time: who received, opened, clicked, bounced, unsubscribed, or complained. Returns { totalCount, result }. Optionally filter to one email address, or for clicks, to one link. For totals and rates only, use directiq_campa
directiq_send_emailSend one transactional email (a receipt, confirmation, or one-to-one message) immediately. It is delivered to real recipients and cannot be recalled, and it counts toward the account’s sending plan. The from address must be a confirmed sender on the account (see directiq_account_
directiq_list_endpointsList known DirectIQ API operations (HTTP method, API group, path, summary). Optionally filter by a search term. Call GET operations with directiq_read_request and POST/PUT/PATCH/DELETE operations with directiq_write_request.
directiq_read_requestIssue an authenticated GET request to any DirectIQ endpoint and return the JSON response. Prefer a dedicated directiq_* tool when one exists; use this for read operations without one, found with directiq_list_endpoints (e.g. segments for a contact, email client reports). Full req
directiq_write_requestIssue an authenticated POST, PUT, PATCH, or DELETE request to any DirectIQ endpoint. May create, modify, or permanently delete account data, including bulk operations. Prefer a dedicated directiq_* tool when one exists; use this only for operations without one, found with directi
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 9, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified against the domain mcp.directiq.com (the registry checks domain ownership)
- … Not checked yet
Still maintained
We have not read this repo from GitHub yet
- … Not checked yet
Has a licence
We have not read this repo from GitHub yet
- ✓ Pass
Endpoint responds
Responded in 255 ms (HTTP 200)
- – Not applicable
Sign-in with OAuth
No sign-in needed
- ✓ Pass
No hidden instructions in tool descriptions
Read 30 tool descriptions and found no hidden instructions to the AI
Compared with others in Marketing & social mediai
- More stars than 0% of the other 3622 servers in this category
- Published to the registry more recently than 77% of the other 3622 servers in this category
- Basic checks equal to or better than 100% of the other 3622 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is DirectIQ safe?
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
You need to fill in: x-api-key
Does it run on my computer or in the cloud?
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
Is it still maintained?
The GitHub repo last changed –, and the latest version (0.2.0) reached the registry 10 days ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.
What can I use instead?
In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
Alternatives
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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, see how your campaigns performed, 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-keyheader, orAuthorization: Bearer(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
- 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.
- Add the server to your client: see the snippets below.
- 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
| Setting | Value |
|---|---|
| Transport | Streamable HTTP |
| URL | https://mcp.directiq.com/mcp |
| Header | x-api-key: |
Tools
30 tools, grouped by what they work on. Full inputs for each tool are in the tool reference.
| Tool | What it does | Behavior |
|---|---|---|
| Account | ||
directiq_account_overview | Summarize the account in one call: total contacts, active/disabled status counts, list count, tag count, and confirmed sender addresses. | read-only |
| Contacts | ||
directiq_get_contact | Get one contact by numeric ID: email, first and last name, status, created and updated dates, tags, lists, and notes. | read-only |
directiq_list_contacts | List contacts one page at a time, oldest first, with each contact's ID, email, name, status, tags, and lists. | read-only |
directiq_contact_count | Return the total number of contacts in the account as a single number. | read-only |
directiq_upsert_contact | Add a contact to a list, creating the contact if the email is new or updating its name if it already exists. | destructive, idempotent |
directiq_update_contact | Update fields on an existing contact by ID, such as firstName, lastName, or email. | destructive, idempotent |
directiq_delete_contact | Permanently delete a contact by ID, removing it from every list and tag. | destructive, idempotent |
| Lists and segments | ||
directiq_list_lists | List every contact list in the account with its ID and name. | read-only |
directiq_get_list | Get one contact list by ID: name, created and modified dates, and total, active, and disabled contact counts. | read-only |
directiq_create_list | Create a new, empty contact list and return it with its new ID. | write |
directiq_rename_list | Rename a contact list by ID. | destructive, idempotent |
directiq_delete_list | Permanently delete a contact list by ID. | destructive, idempotent |
directiq_add_contact_to_list | Add an existing contact (by contact ID) to a list. | write, idempotent |
directiq_remove_contact_from_list | Remove a contact from one list. | destructive, idempotent |
directiq_list_segments | List saved segments (rule-based groups of contacts) with their IDs and names. | read-only |
| Tags | ||
directiq_list_tags | List every tag in the account with its ID and name. | read-only |
directiq_get_tag | Get one tag by ID with its name and details. | read-only |
directiq_create_tag | Create a new tag and return it with its ID. | write |
directiq_rename_tag | Rename a tag by ID. | destructive, idempotent |
directiq_delete_tag | Permanently delete a tag by ID and remove it from every contact. | destructive, idempotent |
directiq_tag_contact | Apply one or more tags to a contact by contact ID. | write, idempotent |
directiq_untag_contact | Remove a tag from a contact, identified by the contact email and the tag name. | destructive, idempotent |
| Campaigns and results | ||
directiq_list_campaigns | List email campaigns and automation flows with ID, name, type (Regular or Flow), status, subject, sender, target lists, recipient count, and scheduled send time. | read-only |
directiq_get_campaign | Get one campaign by ID: name, type, status, subject, sender, target lists and segments, template ID, recipient count, and scheduled send time. | read-only |
directiq_campaign_stats | Summarize how a campaign performed: counts of recipients, opens, clicks, bounces, unsubscribes, and complaints, plus open, click, bounce, and unsubscribe rates as percentages of recipients. | read-only |
directiq_campaign_report | List the contacts behind one campaign result, one page at a time: who received, opened, clicked, bounced, unsubscribed, or complained. | read-only |
| Transactional email | ||
directiq_send_email | Send one transactional email (a receipt, confirmation, or one-to-one message) immediately. | write, open-world |
| Any other endpoint | ||
directiq_list_endpoints | List known DirectIQ API operations (HTTP method, API group, path, summary). | read-only |
directiq_read_request | Issue an authenticated GET request to any DirectIQ endpoint and return the JSON response. | read-only |
directiq_write_request | Issue an authenticated POST, PUT, PATCH, or DELETE request to any DirectIQ endpoint. | destructive |
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 did my last campaign do? Show open, click, and unsubscribe rates."
- "Who clicked in the 'Fall Promo' campaign?"
- "Add jamie@example.com to my Newsletter list as Jamie Lee and tag them 'vip'."
- "Create a list called 'Fall Promo 2026', then move everyone tagged 'vip' into it."
- "Send a transactional email from hello@mybusiness.com to me@mybusiness.com with the subject 'Order confirmed' and a short thank-you message."
Security and data handling
- Your API key is sent only as the
x-api-keyheader over HTTPS tomcp.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.
- Tools marked destructive above can overwrite or permanently delete data (for example
directiq_delete_contact,directiq_delete_list, anddirectiq_write_request). Keep your client's tool-approval prompts on, and only auto-approve read-only tools. - Tool calls without an API key are rejected with HTTP 401; listing the tools works without one.
- 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.