Nuntly

@nuntly/sdk-mcp

Servidor MCP para Nuntly, a plataforma de e-mail que prioriza desenvolvedores. Expõe ferramentas para envio de e-mails, gerenciamento de domínios, webhooks, caixas de entrada e muito mais.

Documentação | Referência do SDK | Obtenha sua chave de API

Sumário

• Requisitos
• Configuração
• Variáveis de ambiente
• Uso programático
• Ferramentas
• FAQ
• Versionamento semântico
• Versões anteriores
• Contribuição
• Licença

Requisitos

• Node.js 20 ou superior (ou Bun)
• Uma chave de API Nuntly de https://nuntly.com/auth/sign-up
• Um cliente compatível com MCP: Claude Desktop, Claude Code, Cursor, Continue ou qualquer integração personalizada baseada no Model Context Protocol

Configuração

Claude Desktop

Adicione à configuração do seu Claude Desktop:

SO	Caminho
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

Use o comando integrado claude mcp add:

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

Em seguida, exporte NUNTLY_API_KEY no seu shell, ou cole este formato em .mcp.json manualmente:

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

Cursor

Adicione às configurações MCP do seu Cursor:

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

Variáveis de ambiente

Variável	Obrigatória	Descrição
NUNTLY_API_KEY	Sim	Sua chave de API Nuntly
NUNTLY_BASE_URL	Não	URL base personalizada da API (padrão: https://api.nuntly.com)

Uso programático

Incorporar o servidor

createMcpServer retorna um McpServer totalmente configurado (todas as ferramentas registradas); conecte-o a qualquer transporte você mesmo.

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());

Integração 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);

Ferramentas

Ferramentas disponíveis:

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

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

Domínios: create-domain, delete-domain, list-domains, retrieve-domain, update-domain

E-mails: cancel-email, list-emails, retrieve-bulk-emails, retrieve-email, retrieve-email-content, retrieve-email-events, retrieve-email-stats, send-bulk-emails, send-email

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

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

Namespaces: create-namespace, delete-namespace, list-namespace-inboxes, list-namespaces, retrieve-namespace, update-namespace

Organizações: list-organizations, retrieve-organization, retrieve-organization-usage

Threads: 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

FAQ

Isso requer Node.js ou Bun? Qualquer um dos dois. O pacote publicado roda em Node.js 20+ via npx @nuntly/sdk-mcp e em Bun via bunx @nuntly/sdk-mcp. A maioria dos clientes MCP inicia npx diretamente.

Preciso de uma conta de provedor de LLM? Não. O servidor MCP apenas fala com a API Nuntly. O cliente LLM (Claude Desktop, Cursor, etc.) gerencia sua própria autenticação de provedor.

Como reporto um bug ou solicito uma ferramenta? Abra uma issue em github.com/nuntly/nuntly-mcp/issues.

Versionamento semântico

Este pacote segue o Semantic Versioning 2.0. A versão publicada acompanha de perto a versão do SDK Nuntly subjacente. Novas ferramentas e adições de argumentos de ferramentas são incrementos menores; remoções de ferramentas ou mudanças que quebram argumentos são incrementos maiores.

Versões anteriores

As versões 0.x permanecem instaláveis via npm através de npm install @nuntly/sdk-mcp@0 para compatibilidade retroativa.

Contribuição

Issues, relatórios de bugs e solicitações de recursos são bem-vindos em github.com/nuntly/nuntly-mcp/issues.

Solução de problemas

O servidor não aparece na lista de ferramentas do Claude Desktop Valide a sintaxe JSON de claude_desktop_config.json (uma vírgula final quebra silenciosamente o arquivo inteiro), saia completamente e reinicie o Claude Desktop, e confirme que o caminho command resolve no seu $PATH (tente executá-lo a partir de um terminal primeiro).

NUNTLY_API_KEY missing na inicialização Obtenha uma chave em nuntly.com e cole-a em env na configuração do seu cliente MCP. O servidor lê a variável do ambiente do processo iniciado, não do seu shell.

A ferramenta retorna isError: true O bloco estruturado content contém um objeto error com status, code e requestId. Use o requestId ao entrar em contato com o suporte. Um 401 significa que a chave de API está ausente, revogada ou com escopo para uma organização diferente.

command not found: npx Instale Node.js 20 ou superior em nodejs.org. npx acompanha o Node e é o alvo de inicialização usado por todos os clientes MCP nos exemplos acima.

Licença

MIT. Veja LICENSE.