Nuntly

@nuntly/sdk-mcp

Servidor MCP para Nuntly, la plataforma de correo electrónico orientada a desarrolladores. Expone herramientas para enviar correos, gestionar dominios, webhooks, bandejas de entrada y más.

Documentación | Referencia del SDK | Obtén tu clave de API

Tabla de contenidos

• Requisitos
• Configuración
• Variables de entorno
• Uso programático
• Herramientas
• Preguntas frecuentes
• Versionado semántico
• Versiones anteriores
• Contribuciones
• Licencia

Requisitos

• Node.js 20 o posterior (o Bun)
• Una clave de API de Nuntly desde https://nuntly.com/auth/sign-up
• Un cliente compatible con MCP: Claude Desktop, Claude Code, Cursor, Continue, o cualquier integración personalizada basada en el Model Context Protocol

Configuración

Claude Desktop

Añade a tu configuración de Claude Desktop:

SO	Ruta
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nuntly": {
      "command": "npx",
      "args": ["@nuntly/sdk-mcp"],
      "env": {
        "NUNTLY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Usa el comando integrado claude mcp add:

claude mcp add nuntly -- npx @nuntly/sdk-mcp

Luego exporta NUNTLY_API_KEY en tu shell, o pega esta forma en .mcp.json manualmente:

{
  "mcpServers": {
    "nuntly": {
      "command": "npx",
      "args": ["@nuntly/sdk-mcp"],
      "env": {
        "NUNTLY_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Añade a tu configuración de MCP de Cursor:

{
  "mcpServers": {
    "nuntly": {
      "command": "npx",
      "args": ["@nuntly/sdk-mcp"],
      "env": {
        "NUNTLY_API_KEY": "your-api-key"
      }
    }
  }
}

Variables de entorno

Variable	Requerida	Descripción
NUNTLY_API_KEY	Sí	Tu clave de API de Nuntly
NUNTLY_BASE_URL	No	URL base de API personalizada (por defecto: https://api.nuntly.com)

Uso programático

Incrustar el servidor

createMcpServer devuelve un McpServer completamente configurado (todas las herramientas registradas); conéctalo a cualquier transporte tú mismo.

import { createMcpServer } from '@nuntly/sdk-mcp/ai';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = createMcpServer({ apiKey: process.env.NUNTLY_API_KEY });
await server.connect(new StdioServerTransport());

Integración personalizada

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { Nuntly } from '@nuntly/sdk';
import { registerTools } from '@nuntly/sdk-mcp';

const server = new McpServer({ name: 'my-server', version: '1.0.0' });
const nuntly = new Nuntly({ apiKey: process.env.NUNTLY_API_KEY });
registerTools(server, nuntly);

Herramientas

Herramientas disponibles:

Agentes: retrieve-agent-memory, upsert-agent-memory

Claves de API: create-api-key, delete-api-key, list-api-keys, retrieve-api-key, update-api-key

Dominios: create-domain, delete-domain, list-domains, retrieve-domain, update-domain

Correos electrónicos: cancel-email, list-emails, retrieve-bulk-emails, retrieve-email, retrieve-email-content, retrieve-email-events, retrieve-email-stats, send-bulk-emails, send-email

Bandejas de entrada: create-inbox, delete-inbox, list-inboxes, retrieve-inbox, send-inbox-message, update-inbox

Mensajes: forward-message, list-message-attachments, list-messages, reply-to-message, retrieve-message, retrieve-message-attachment, retrieve-message-content, update-message

Espacios de nombres: create-namespace, delete-namespace, list-namespace-inboxes, list-namespaces, retrieve-namespace, update-namespace

Organizaciones: list-organizations, retrieve-organization, retrieve-organization-usage

Hilos: list-inbox-threads, list-thread-messages, retrieve-thread, update-thread

Webhooks: create-webhook, delete-webhook, list-webhooks, retrieve-webhook, update-webhook

Eventos de Webhooks: list-webhook-event-deliveries, list-webhooks-events, replay-webhook-event

Preguntas frecuentes

¿Requiere Node.js o Bun? Cualquiera. El paquete publicado se ejecuta en Node.js 20+ mediante npx @nuntly/sdk-mcp y en Bun mediante bunx @nuntly/sdk-mcp. La mayoría de los clientes MCP lanzan npx directamente.

¿Necesito una cuenta de proveedor de LLM? No. El servidor MCP solo se comunica con la API de Nuntly. El cliente LLM (Claude Desktop, Cursor, etc.) maneja su propia autenticación de proveedor.

¿Cómo reporto un error o solicito una herramienta? Abre un issue en github.com/nuntly/nuntly-mcp/issues.

Versionado semántico

Este paquete sigue Semantic Versioning 2.0. La versión publicada sigue de cerca la versión del SDK de Nuntly subyacente. Las nuevas herramientas y adiciones de argumentos de herramientas son incrementos menores; las eliminaciones de herramientas o cambios que rompen argumentos son incrementos mayores.

Versiones anteriores

Las versiones 0.x siguen siendo instalables desde npm mediante npm install @nuntly/sdk-mcp@0 para compatibilidad hacia atrás.

Contribuciones

Los issues, informes de errores y solicitudes de funciones son bienvenidos en github.com/nuntly/nuntly-mcp/issues.

Solución de problemas

El servidor no aparece en la lista de herramientas de Claude Desktop Valida la sintaxis JSON de claude_desktop_config.json (una coma final rompe silenciosamente todo el archivo), cierra y reinicia completamente Claude Desktop, y confirma que la ruta command se resuelve en tu $PATH (prueba ejecutándola desde una terminal primero).

NUNTLY_API_KEY missing al inicio Obtén una clave de nuntly.com y pégala bajo env en la configuración de tu cliente MCP. El servidor lee la variable del entorno del proceso generado, no de tu shell.

La herramienta devuelve isError: true El bloque estructurado content contiene un objeto error con status, code y requestId. Usa el requestId al contactar con soporte. Un 401 significa que la clave de API falta, está revocada o está limitada a una organización diferente.

command not found: npx Instala Node.js 20 o posterior desde nodejs.org. npx se incluye con Node y es el objetivo de lanzamiento utilizado por cada cliente MCP en los ejemplos anteriores.

Licencia

MIT. Ver LICENSE.