Skip to main content
Glama
deenesjakoruzh
design-smith

MuntuAI MCP

by design-smith
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

MuntuAI MCP

本仓库包含在线 MuntuAI MCP 服务器的公开文档、清单和参考客户端。可运行的服务器实现位于 Muntu 主后端中。

官方 Model Context Protocol (MCP) 服务器，面向 MuntuAI — 让 AI 智能体能够以编程方式访问邮件外联营销活动、潜在客户管理、域名基础设施和实时工作区事件。

这是什么

MuntuAI 是一个 AI 原生的邮件外联平台。该 MCP 服务器允许外部智能体（Claude、Cursor、自定义脚本）连接到 MuntuAI 工作区并执行操作：创建营销活动、导入线索、验证域名、发送电子邮件、订阅 Webhook 事件 — 全部通过基于 HTTP 的标准 MCP 接口完成。

协议： Model Context Protocol 基于 HTTP（JSON-RPC 2.0）
传输方式： Streamable HTTP（text/event-stream 或 application/json）
服务器协议版本： 2025-03-26
服务器 URL： https://api.muntuai.com/api/mcp

Related MCP server: Tratto MCP Server

快速开始

1. 获取智能体密钥

登录 app.muntuai.com，进入 设置 → 智能体密钥 并创建一个密钥。选择与你的智能体需求匹配的自主级别：

级别

可执行操作

observer

可读取任何内容 — 营销活动、线索、域名、发件人、事件

copilot

读取 + 创建和修改 — 营销活动、域名、发件人、线索、Webhook

autonomous

以上全部 + 暂停、恢复、删除

你只会看到一次原始密钥：mnt_<keyId>.<secret>。请立即复制。

2. 配置客户端

安全说明：将原始智能体密钥存储在环境变量或密钥管理器中。不要将其提交到源代码控制或粘贴到共享文件中。

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "muntu": {
      "url": "https://api.muntuai.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
      }
    }
  }
}

Cursor (.cursor/mcp.json 或设置 → MCP):

{
  "mcpServers": {
    "muntu": {
      "url": "https://api.muntuai.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
      }
    }
  }
}

Python：

pip install requests
export MUNTU_AGENT_KEY="mnt_YOUR_KEY_HERE"
python clients/python/muntu_mcp_client.py list-campaigns

推荐配置：

export MUNTU_SESSION_ID="$(uuidgen)"

Muntu 使用可选的 MUNTU_SESSION_ID 将请求分组到同一个逻辑 MCP 会话中，以实现会话级安全控制和预算管理。

3. 发起第一次调用

连接后，让你的智能体执行：

“列出我 MuntuAI 工作区中的所有营销活动”

智能体会调用 resources/read，访问 muntu://campaigns/{workspaceId} 并返回营销活动列表。

或者通过 Python CLI：

python clients/python/muntu_mcp_client.py list-campaigns
python clients/python/muntu_mcp_client.py list-domains
python clients/python/muntu_mcp_client.py list-emails

智能体可执行的操作

资源（只读视图）

资源

URI

描述

workspace

muntu://workspace/{id}

配置文件、策略、基础设施计数

domains

muntu://domains/{id}?cursor=0&limit=50

所有域名及其 DNS 和验证状态

senders

muntu://senders/{id}?cursor=0&limit=50

所有电子邮件账户及其状态

campaigns

muntu://campaigns/{id}?cursor=0&limit=20

统一的营销活动列表

campaign-plans

muntu://campaign-plans/{id}?cursor=0&limit=20

草稿审核队列

events

muntu://events/{id}?cursor=0

最近的系统事件（可筛选）

工具（共 30 个）

按领域分组 — 完整索引见 tools/README.md。

  • Campaigns — 创建、启动、暂停、恢复、监控、审阅草稿、发送

  • Leads — 从数组或 CSV URL 导入、补全、抽样

  • Senders — 创建、删除、健康检查、分配到营销活动

  • Domains — 添加、验证、检查状态

  • Email generation — 预览、优化、生成营销活动指南

  • Webhooks — 订阅工作区事件

  • Meta — 获取智能体密钥信息

仓库结构

muntuai-mcp/
├── README.md                    # This file
├── QUICKSTART.md                # 5-minute setup guide
├── docs/
│   ├── authentication.md        # Token format, headers, rate limits
│   ├── autonomy-levels.md       # Permission model
│   ├── resources.md             # All 6 resources with schemas
│   ├── events.md                # All event types and payloads
│   ├── webhooks.md              # Register, sign, verify
│   └── errors.md                # Error codes and handling
├── tools/
│   ├── README.md                # Full tool index
│   ├── campaigns.md
│   ├── leads.md
│   ├── senders.md
│   ├── domains.md
│   ├── email-generation.md
│   └── meta.md
├── workflows/
│   ├── README.md                # What workflows are
│   ├── launch-first-campaign.md
│   ├── review-and-send-drafts.md
│   ├── domain-setup.md
│   └── monitor-campaign.md
├── reference/
│   ├── event-types.md
│   ├── resource-schemas.md
│   └── tool-schemas.md
├── clients/
│   └── python/
│       ├── muntu_mcp_client.py  # Reference Python client
│       ├── README.md
│       └── examples/
├── agent-guides/
│   ├── for-claude.md
│   ├── for-cursor.md
│   └── decision-guide.md
└── .well-known/
    └── mcp-manifest.json        # Machine-readable capabilities manifest

核心概念

工作区 — MuntuAI 中的所有数据都限定在一个工作区内。你的智能体密钥绑定到一个工作区，只能访问该工作区内的数据。

自主级别 — 每个工具都有最低所需级别。如果你的密钥级别低于要求，调用将被拒绝，且尝试会被记录。参见 docs/autonomy-levels.md。

营销活动生命周期 — uploaded → enriching → drafting → sending → completed。智能体可以通过 get_campaign_performance 和 events 资源观察这一生命周期。参见 workflows/monitor-campaign.md。

域名验证 — 发送前，必须先向电子邮件提供商验证域名。这涉及发布 DNS 记录并触发验证。参见 workflows/domain-setup.md。

支持

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • @sendbyte/mcp by Sendbyte-Africa

    @sendbyte/mcpofficial

    Sendbyte-Africa
    A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to send emails and manage sending domains, templates, analytics, and content checks through the SendByte platform using the Model Context Protocol.
    11
    8 npm
    MIT
  • Tratto MCP Server by tratto-email

    Tratto MCP Serverofficial

    tratto-email
    F
    license
    A
    quality
    F
    maintenance
    Lets AI tools send transactional emails, check status, and manage contacts through the Model Context Protocol.
    2
    -
  • @sendraven/mcp by CommonNinja

    @sendraven/mcpofficial

    CommonNinja
    A
    license
    B
    quality
    B
    maintenance
    Enables AI agents to send and manage email, read threaded replies, run campaigns and automations, and handle approvals through the Model Context Protocol from any compatible client.
    45
    186 npm
    1
    MIT
  • vaemail by vaemail

    vaemailofficial

    vaemail
    A
    license
    A
    quality
    A
    maintenance
    Enables AI agents to send transactional email, authenticate sending domains, track delivery, and diagnose deliverability issues programmatically.
    13
    33 npm
    MIT