Mailrith email marketingプラットフォーム内で、購読者、ブロードキャスト、シーケンス、オートメーション、およびレポートの管理を行います。
別名 anrawool/mailrith-agent-platform, mailrith, @mailrith/mcp-server
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- 771
- 最新バージョン
- 2.0.1
- 最終コミット
- 2026年11月11日
- ライセンス
- MIT
Mailrith MCPとは
Mailrith email marketingプラットフォーム内で、購読者、ブロードキャスト、シーケンス、オートメーション、およびレポートの管理を行います。
プロジェクトのREADMEから生成された概要
Mailrith MCP server について
Mailrith Email Marketingは、MCP serverを通じてメールマーケティング業務を管理するためのインターフェースを提供します。開発者やユーザーは、購読者、ブロードキャスト、シーケンス、およびオートメーションを操作できます。このサーバーは、api.mailrith.com/mcpでのホストされたエンドポイントを介したリモート接続と、stdioまたはセルフホストされたHTTPトランスポートを使用したローカルインストールの両方をサポートしています。Claude DesktopなどのリモートクライアントはMailrith OAuthを使用して接続しますが、ローカルのstdioセットアップでは、MAILRITH_API_KEY環境変数を通じて提供されるワークスペースAPIキーが必要です。
このサーバーは、submitted、compact、customを含む異なる互換性プロファイルを提供します。submittedプロファイルは汎用的なエージェント向けに設計されており、subscribers_list、broadcasts_create、broadcasts_scheduleなどのツールが含まれています。ユーザーに許可されたOAuthスコープまたはワークスペースAPIキーに基づいて、厳格な権限チェックが適用されます。また、オートメーションの読み取り時に機密性の高いwebhookトークンを伏せ字にし、シェル履歴への露出を防ぐためにコマンド引数として渡された認証情報を拒否することで、セキュリティを確保しています。
できること
- 1メール購読者リストの管理現在のメール購読者リストを取得または表示するようAIに依頼します。
- 2マーケティングブロードキャストのスケジューリングエージェントに対して、特定の時間に新しいメールブロードキャストを準備し、スケジュールするよう指示します。
- 3オートメーションステータスの更新クライアントを使用して、既存のメールオートメーションやシーケンスのステータスを変更します。
- 4ブロードキャストの事前チェックの実行エージェントを使用して、ブロードキャストが受信者に正式に送信される前に検証を行います。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Mailrith MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにMailrith MCPをインストール
$ claude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-serverCursorにMailrith MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}VS CodeにMailrith MCPをインストール
.vscode/mcp.json
{
"servers": {
"mailrith": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}VS Code CLIにMailrith MCPをインストール
$ code --add-mcp '{"name":"mailrith","type":"stdio","command":"npx","args":["-y","@mailrith/mcp-server"],"env":{"MAILRITH_API_KEY":"<YOUR_MAILRITH_API_KEY>"}}'Claude DesktopにMailrith MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}CodexにMailrith MCPをインストール
$ codex mcp add mailrith --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' -- npx -y @mailrith/mcp-serverCodex config.tomlにMailrith MCPをインストール
~/.codex/config.toml
[mcp_servers.mailrith] command = "npx" args = ["-y", "@mailrith/mcp-server"] [mcp_servers.mailrith.env] MAILRITH_API_KEY = "<YOUR_MAILRITH_API_KEY>"
Gemini CLIにMailrith MCPをインストール
$ gemini mcp add -s user -e 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith npx -- -y @mailrith/mcp-serverGemini settings.jsonにMailrith MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}設定
MAILRITH_API_KEY必須シークレットA Mailrith workspace API key.
| 名前 | 説明 | 種類 |
|---|---|---|
| MAILRITH_API_KEY | A Mailrith workspace API key. | 必須シークレット |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能anrawool/mailrith-agent-platform is public and reachablegithub.com/anrawool/mailrith-agent-platform ↗合格
- パッケージがこのリポジトリをソースとして指定@mailrith/mcp-server names anrawool/mailrith-agent-platform as sourcenpmjs.com/package/@mailrith/mcp-server ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for @mailrith/mcp-servernpmjs.com/package/@mailrith/mcp-server/v/2.0.1#provenance ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-11github.com/anrawool/mailrith-agent-platform ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @mailrith/mcp-server合格
- パッケージおよびその依存関係に重大な勧告なし101 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 98 ms合格
README
GitHubで見るMailrith MCP Server
Official MCP server for Mailrith.
The server uses the stable @modelcontextprotocol/sdk package for hosted and
stdio transports while preserving Mailrith's generated operation schemas.
Use the remote MCP endpoint at https://api.mailrith.com/mcp for hosted agent
integrations, or run the local server from this repo for stdio or self-hosted HTTP use.
Claude Desktop and other user-connected remote MCP clients authenticate through
Mailrith OAuth. Code-first clients that can safely store credentials may send a
workspace API key or OAuth access token as Authorization: Bearer <credential>.
Official MCP Registry
The registry metadata in server.json identifies the server as
com.mailrith/mailrith. Clients can use the canonical Streamable HTTP endpoint
at https://api.mailrith.com/mcp, which authenticates through OAuth, or install
the local stdio package from npm. Local installs require a workspace API key in
MAILRITH_API_KEY.
The hosted server requests Full Email Marketing Access by default for a
general-purpose agent. It covers every public email-marketing operation in the
selected workspace, but not billing, team, account-security,
credential-reading, or internal administration. The
discovery_get_capabilities connection check requests the complete public
permission catalog so Mailrith can show every Work Profile and default to Full
Email Marketing Access. The user can choose Reporting, another focused Work
Profile, or custom permissions instead. OAuth stores only the permissions the
user approves, and every tool checks those permissions again when it runs.
MAILRITH_API_KEY="<secret>" pnpm --filter @mailrith/mcp-server exec tsx src/cli.ts --transport stdio
Local stdio reads MAILRITH_API_KEY from the client secret environment. The
server rejects credentials passed as command arguments so they do not appear in
process listings or shell history. Local stdio stops with a clear setup error
when the environment variable is missing because it has no browser-based OAuth
flow.
Self-hosted HTTP does not read a process-wide API key. Each client must send its
own workspace API key or OAuth access token in the Authorization header. The
built-in HTTP listener accepts only 127.0.0.1 or localhost; put a TLS reverse
proxy in front of it when another machine needs access.
The default submitted profile exposes a fixed reviewed catalog of focused
tools such as:
subscribers_listbroadcasts_createbroadcasts_preflightbroadcasts_schedulebroadcasts_sendsequences_update_statusautomations_update_status
Every submitted tool has a human-readable top-level title and
annotations.title, a narrow description, exact input and output schemas,
explicit safety annotations, and machine-readable operation permissions.
Request-body inputs expose their JSON type directly as well as their exact
referenced schema so connector review tools can validate them without expanding
$ref values first. Tools other than the connection check advertise their
exact OAuth permissions. The connection check advertises the complete
permission catalog so OAuth can offer every Work Profile; its result still
reports the exact permissions granted to the connection. The catalog stays the
same for every user so clients can review and select tools reliably. Workspace
role, plan, product readiness, and granted permissions are enforced when a tool
runs.
Anonymous clients may initialize and list this static catalog so ChatGPT and
other hosts can start OAuth linking. Anonymous tool calls never reach the
Mailrith product API and return HTTP 401 with a standards-based
WWW-Authenticate challenge instead. Authenticated calls that need more
permissions return HTTP 403 with the complete replacement permission set.
Single-tool responses also include MCP's tool-level OAuth challenge metadata
for clients that use it when linking or reconnecting an account.
Each anonymous HTTP request accepts one JSON-RPC message. Authenticated
requests may batch up to 25 messages. These limits keep discovery and tool
responses predictable for every connected workspace.
Automation reads never return saved webhook bearer tokens or custom header values. They return only whether each value is configured. If a client reads an Automation and sends the redacted definition back during an update, Mailrith preserves the existing values unless the client explicitly replaces or removes them. Changing the webhook destination requires new credential values so an old secret cannot be carried to another service.
The package also preserves two explicit compatibility profiles:
compactexposes the earlier seven discovery and routing tools.customexposes generated focused tools with caller-selected Work Profile, permission, and read-only filters.
Use these profiles only for local or purpose-built clients. The public ChatGPT/Codex plugin
and the Claude Connector use the fixed submitted profile at the single /mcp
endpoint.
Official Builds And Forks
Modified public versions must use distinct package, registry, plugin, and service names and clearly say that they are unofficial. See the Mailrith Trademark And Unofficial Fork Policy.
Mailrith MCPのよくある質問
Mailrith MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-serverを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Mailrith MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Mailrith MCP serverへの認証方法を教えてください。
Claude Desktopやその他のリモートクライアントはMailrith OAuthを使用します。コードベースのクライアントは、AuthorizationヘッダーにワークスペースAPIキーまたはOAuthアクセストークンを使用できます。
デフォルトのプロファイルではどのようなツールが利用可能ですか?
デフォルトの「submitted」プロファイルには、購読者の管理、ブロードキャストの作成とスケジューリング、およびシーケンスやオートメーションのステータス更新を行うためのツールが含まれています。