marketo-mcp-server
marketo-mcp-server
一个用于 Marketo 的模型上下文协议 (MCP) 服务器 — 让 Claude 和其他 AI 助手能够直接访问您的 Marketo 实例。
通过自然语言查询潜在客户、检查程序、审查电子邮件和表单、管理静态和智能列表、探索渠道和落地页,以及启动批量导出。
功能
分类 | 您可以执行的操作 |
潜在客户 (Leads) | 按 ID 或电子邮件获取、批量创建/更新、删除、检索活动日志 |
程序 (Programs) | 列出、按 ID 获取、克隆、获取成员 |
电子邮件 (Emails) | 列出、按 ID 获取、克隆、发送样本/测试 |
表单 (Forms) | 列出、按 ID 获取、克隆、批准 |
智能列表 (Smart Lists) | 列出、按 ID 获取(包含完整的筛选器定义) |
静态列表 (Static Lists) | 获取成员、添加潜在客户、移除潜在客户 |
渠道 (Channels) | 列出、按 ID 获取、创建(包含进度状态) |
落地页 (Landing Pages) | 列出、按 ID 获取、克隆 |
批量导出 (Bulk Export) | 创建作业、加入队列、轮询状态、下载文件 |
前置要求
Node.js 20+
具有 REST API 访问权限的 Marketo 实例
一个 Marketo API 专用用户和 LaunchPoint 服务,并提供 Client ID 和 Client Secret
设置
1. 获取您的 Marketo REST 凭据
在 Marketo 管理后台:Integration → LaunchPoint → 创建或选择一个服务 → 复制 Client ID 和 Secret。您的基础 URL 位于 Integration → Web Services 下(例如 https://xxx-xxx-xxx.mktorest.com)。
2. 设置环境变量
MARKETO_CLIENT_ID=your_client_id
MARKETO_CLIENT_SECRET=your_client_secret
MARKETO_BASE_URL=https://xxx-xxx-xxx.mktorest.com使用方法
Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"marketo": {
"command": "npx",
"args": ["marketo-mcp-server"],
"env": {
"MARKETO_CLIENT_ID": "your_client_id",
"MARKETO_CLIENT_SECRET": "your_client_secret",
"MARKETO_BASE_URL": "https://xxx-xxx-xxx.mktorest.com"
}
}
}
}Claude Code
claude mcp add marketo-mcp-server npx marketo-mcp-server \
-e MARKETO_CLIENT_ID=your_client_id \
-e MARKETO_CLIENT_SECRET=your_client_secret \
-e MARKETO_BASE_URL=https://xxx-xxx-xxx.mktorest.comCursor
添加到项目根目录下的 .cursor/mcp.json(或全局 ~/.cursor/mcp.json):
{
"mcpServers": {
"marketo": {
"command": "npx",
"args": ["marketo-mcp-server"],
"env": {
"MARKETO_CLIENT_ID": "your_client_id",
"MARKETO_CLIENT_SECRET": "your_client_secret",
"MARKETO_BASE_URL": "https://xxx-xxx-xxx.mktorest.com"
}
}
}
}Docker
docker build -t marketo-mcp-server .
docker run -e MARKETO_CLIENT_ID=... -e MARKETO_CLIENT_SECRET=... -e MARKETO_BASE_URL=... marketo-mcp-server工具参考
潜在客户 (5 个工具)
工具 | 描述 |
| 通过 Marketo 潜在客户 ID 获取单个潜在客户 |
| 通过电子邮件地址查找潜在客户 |
| 批量插入/更新最多 300 个潜在客户 |
| 通过 ID 永久删除潜在客户 |
| 获取潜在客户的活动日志(可按活动类型筛选) |
程序 (4 个工具)
工具 | 描述 |
| 列出程序(支持分页和类型/日期筛选) |
| 按 ID 获取完整的程序元数据 |
| 将程序及其所有本地资产克隆到目标文件夹 |
| 获取加入程序的潜在客户 |
电子邮件 (4 个工具)
工具 | 描述 |
| 列出电子邮件资产(支持状态筛选) |
| 获取完整的电子邮件元数据(包括 HTML 和模块结构) |
| 将电子邮件资产克隆到目标文件夹 |
| 发送测试/样本电子邮件,可选择使用潜在客户的令牌进行渲染 |
表单 (4 个工具)
工具 | 描述 |
| 列出表单(支持分页和状态筛选) |
| 获取表单元数据(包括字段和可见性规则) |
| 将表单克隆到目标文件夹 |
| 批准表单草稿以使其生效 |
智能列表 (2 个工具)
工具 | 描述 |
| 列出智能列表(支持分页) |
| 获取包含完整筛选器定义的智能列表 |
静态列表 (3 个工具)
工具 | 描述 |
| 获取属于静态列表成员的潜在客户 |
| 将最多 300 个潜在客户添加到静态列表 |
| 从静态列表中移除最多 300 个潜在客户 |
渠道 (3 个工具)
工具 | 描述 |
| 列出所有渠道及其进度状态 |
| 按 ID 获取单个渠道 |
| 创建具有自定义进度状态的渠道 |
落地页 (3 个工具)
工具 | 描述 |
| 列出落地页(支持状态筛选) |
| 获取完整的落地页元数据(包括模板和嵌入的表单) |
| 将落地页克隆到目标文件夹 |
批量导出 (4 个工具)
工具 | 描述 |
| 创建批量潜在客户导出作业(包含字段列表和日期筛选器) |
| 将创建的导出作业加入处理队列 |
| 轮询正在运行的导出作业的状态 |
| 从已完成的导出作业中下载文件 |
示例提示词
“显示本周从 Webinar 来源创建的所有潜在客户”
“当前有哪些活跃的程序,每个程序属于哪个渠道?”
“查找 Contact Us 落地页上的所有表单并显示其字段”
“将 Q1 Webinar 程序克隆到 Q2 文件夹中,并命名为 Q2 Webinar”
“将过去 30 天内更新的所有潜在客户导出为 CSV — 包含 email, firstName, lastName, company”
“发送 ID 为 1234 的电子邮件样本到 test@example.com,并使用潜在客户 5678 的数据进行渲染”
身份验证
Marketo 使用 OAuth 2.0 客户端凭据。服务器会自动获取并缓存令牌,并在过期前 60 秒刷新。无需手动管理令牌。
许可证
MIT — 详见 LICENSE。
Maintenance
Related MCP Connectors
Mailchimp MCP Pack — manage audiences, campaigns, and members via Mailchimp Marketing API.
Klaviyo MCP Pack — wraps the Klaviyo API for email marketing
34 production API tools over one hosted MCP endpoint.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ZLeventer/marketo-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server