Gestiona suscriptores, envíos masivos, secuencias, automatizaciones e informes dentro de la plataforma de email marketing Mailrith.
También conocido como anrawool/mailrith-agent-platform, mailrith, @mailrith/mcp-server
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- 771
- Última versión
- 2.0.1
- Último commit
- 11 nov 2026
- Licencia
- MIT
¿Qué es Mailrith MCP?
Gestiona suscriptores, envíos masivos, secuencias, automatizaciones e informes dentro de la plataforma de email marketing Mailrith.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Mailrith
Mailrith Email Marketing proporciona una interfaz para gestionar operaciones de email marketing a través de un MCP server. Los desarrolladores y usuarios pueden interactuar con suscriptores, envíos masivos, secuencias y automatizaciones. El servidor admite tanto conexiones remotas mediante un endpoint alojado en api.mailrith.com/mcp como instalaciones locales utilizando transportes stdio o HTTP autoalojados. Los clientes remotos como Claude Desktop se conectan mediante Mailrith OAuth, mientras que las configuraciones locales con stdio requieren una API key de espacio de trabajo proporcionada a través de la variable de entorno MAILRITH_API_KEY.
Este servidor ofrece diferentes perfiles de compatibilidad que incluyen submitted, compact y custom. El perfil submitted está diseñado para agentes de propósito general e incluye herramientas como subscribers_list, broadcasts_create y broadcasts_schedule. Aplica controles de permisos estrictos basados en los scopes de OAuth otorgados al usuario o en la API key del espacio de trabajo. El sistema garantiza la seguridad redactando tokens de webhook sensibles durante las lecturas de automatizaciones y rechazando credenciales pasadas como argumentos de comando para evitar su exposición en el historial de la shell.
Qué puedes hacer con él
- 1Gestionar listas de suscriptores de emailPide a la IA que recupere o visualice tu lista actual de suscriptores de correo electrónico.
- 2Programar envíos masivos de marketingIndica al agente que prepare y programe un nuevo envío masivo de correos para una hora específica.
- 3Actualizar estados de automatizaciónPermite que el cliente modifique el estado de las automatizaciones o secuencias de email existentes.
- 4Realizar comprobaciones previas de envíosUtiliza el agente para validar un envío masivo antes de que se envíe oficialmente a los destinatarios.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Mailrith MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Mailrith MCP en Claude Code
$ claude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-serverInstalar Mailrith MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Instalar Mailrith MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mailrith": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Instalar Mailrith MCP en VS Code CLI
$ code --add-mcp '{"name":"mailrith","type":"stdio","command":"npx","args":["-y","@mailrith/mcp-server"],"env":{"MAILRITH_API_KEY":"<YOUR_MAILRITH_API_KEY>"}}'Instalar Mailrith MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Instalar Mailrith MCP en Codex
$ codex mcp add mailrith --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' -- npx -y @mailrith/mcp-serverInstalar Mailrith MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.mailrith] command = "npx" args = ["-y", "@mailrith/mcp-server"] [mcp_servers.mailrith.env] MAILRITH_API_KEY = "<YOUR_MAILRITH_API_KEY>"
Instalar Mailrith MCP en Gemini CLI
$ gemini mcp add -s user -e 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith npx -- -y @mailrith/mcp-serverInstalar Mailrith MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Configuración
MAILRITH_API_KEYObligatorioSecretoA Mailrith workspace API key.
| Nombre | Descripción | Tipo |
|---|---|---|
| MAILRITH_API_KEY | A Mailrith workspace API key. | ObligatorioSecreto |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleanrawool/mailrith-agent-platform is public and reachablegithub.com/anrawool/mailrith-agent-platform ↗Aprobado
- El paquete indica este repositorio como su origen@mailrith/mcp-server names anrawool/mailrith-agent-platform as sourcenpmjs.com/package/@mailrith/mcp-server ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for @mailrith/mcp-servernpmjs.com/package/@mailrith/mcp-server/v/2.0.1#provenance ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-11github.com/anrawool/mailrith-agent-platform ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @mailrith/mcp-serverAprobado
- No hay avisos críticos en el paquete ni en sus dependencias101 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 98 msAprobado
README
Ver en GitHubMailrith 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.
Preguntas sobre Mailrith MCP
¿Cómo agrego Mailrith MCP a Claude Code?
Ejecuta claude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-server en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Mailrith MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo me autentico con el Mailrith MCP server?
Claude Desktop y otros clientes remotos utilizan Mailrith OAuth, mientras que los clientes basados en código pueden usar una API key de espacio de trabajo o un token de acceso OAuth en el header de Authorization.
¿Qué herramientas están disponibles en el perfil por defecto?
El perfil 'submitted' por defecto incluye herramientas para gestionar suscriptores, crear y programar envíos masivos, y actualizar el estado de secuencias y automatizaciones.