Skip to main content
Glama
design-smith

MuntuAI MCP

by design-smith

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-streamapplication/json
服务器协议版本: 2025-03-26
服务器 URL: https://api.muntuai.com/api/mcp


Related MCP server: KeyID Agent Kit

快速开始

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


支持

F
license - not found
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    A Model Context Protocol server that provides AI coding assistants (Claude, Cursor, etc.) with access to SmartLead's cold email automation platform through 116+ API endpoints for campaign management, lead tracking, and email delivery.
    215
    21
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides AI agents with a free, functional email address via the Model Context Protocol without requiring manual registration. It enables comprehensive email capabilities including sending, receiving, and managing messages, contacts, and automated settings.
    86
    666
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to send emails, manage campaigns, subscribers, templates, and domains via the SendCraft email API.
    26
    26
    MIT
  • 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
    13
    MIT

View all related MCP servers

Related MCP Connectors

  • Email for AI agents — send, receive as a webhook, manage domains, templates, routing.

  • Email for AI agents: send mail, manage contacts, automations & webhooks. Zero-DNS first send.

  • AI agents read & send email, manage mailboxes, domains and webhooks via the QMailing API.

View all MCP Connectors

Latest Blog Posts

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/design-smith/MuntuAI-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server