DirectIQ
概览
作者提供的说明(英文原文)
Manage DirectIQ contacts, lists and tags, see campaign results, and send transactional email.
PopNx MCP 的三大支柱
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
- 用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
- 我们的基础检查i3 项中通过 3 项依据公开信息检查;尚未扫描代码
- 使用情况i非常新★ –
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 在云端运行
- 传输方式: Streamable HTTP
- 分类: 营销与社交媒体
- 你需要填写:x-api-key
安装
选择你使用的 AI 应用,然后复制设置。
安装之前
- 基础检查:3 项中通过 3 项
- 在作者的服务器上运行:你向它提出的内容会经过他们的服务器。
- 可以做 30 件事(工具) directiq_account_overview, directiq_get_contact, directiq_list_contacts, directiq_contact_count …
- 需要你自己填写:
x-api-key
标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。
你需要
- 在云端运行无需安装任何东西,通过互联网连接
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
这个地址需要在请求的 header 中放入密钥,而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。
在终端中运行这条命令
claude mcp add --transport http directiq https://mcp.directiq.com/mcp --header 'x-api-key: your-value'运行前请先填写空着的值。
或者自己复制设置
粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"directiq": {
"url": "https://mcp.directiq.com/mcp",
"headers": {
"x-api-key": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
或者自己复制设置
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"directiq": {
"type": "http",
"url": "https://mcp.directiq.com/mcp",
"headers": {
"x-api-key": "your-value"
}
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
这个地址需要在请求的 header 中放入密钥,而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。
你的选择通过 Cookie 保存在这台设备上,无需账户。
需要你填写的值
x-api-key机密 必填 HTTP headerDirectIQ API key (Dashboard > Settings > API Keys)
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
它能做什么
工具名称和描述与服务器在 2026年11月7日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
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
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 mcp.directiq.com 验证(注册中心会核实域名所有权)
- … 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
- … 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
- ✓ 通过
端点有响应
在 255 毫秒内响应(HTTP 200)
- – 不适用
使用 OAuth 登录
无需登录
- ✓ 通过
工具描述中没有隐藏指令
已读取 30 个工具描述,未发现针对 AI 的隐藏指令
与“营销与社交媒体”中的其他服务器比较i
- 星标数多于此分类中其他 3596 个服务器的 0%
- 发布到注册中心的时间比此分类中其他 3596 个服务器的 78% 更新
- 基础检查结果等于或优于此分类中其他 3596 个服务器的 100%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
DirectIQ 安全吗?
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
你需要填写:x-api-key
它在我的电脑上运行还是在云端?
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
它还在维护吗?
GitHub 仓库最后更新于–,最新版本(0.2.0)于9天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。
有什么可以替代它?
同一分类中有:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
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
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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.