Model Context Protocol

MCP Server

Conecte agentes de IA (Claude, Cursor, Cline…) ao CoolMail via Model Context Protocol: o agente cria a inbox, espera o e-mail e lê o código de verificação — sem painel, sem copiar-e-colar.

Endpoint

POST https://coolmail.click/api/v1/mcp

Autenticação

Bearer cmk_live_… (a mesma chave da API REST)

Ferramentas

create_inboxcria uma inbox (debita R$5 do saldo — o cliente MCP pede sua confirmação; máx. 100/dia por chave). Parâmetros opcionais: alias e domain (TLD do pool, mesmo preço — a descrição da tool lista os domínios disponíveis)

list_inboxeslista as inboxes da conta

wait_for_emaillong-poll de até 25s esperando um código de verificação chegar na inbox

get_messagelê o conteúdo completo de uma mensagem (texto, código e links)

extract_otpextrai só o código de verificação de uma mensagem

extract_linksextrai os links de uma mensagem (o melhor palpite de link de verificação vem primeiro)

Configurar no seu cliente

Adicione um conector MCP customizado apontando pro endpoint com sua chave no header Authorization. Exemplo de config (Cursor / Cline):

mcp.json

{
  "mcpServers": {
    "coolmail": {
      "url": "https://coolmail.click/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer cmk_live_SUA_CHAVE"
      }
    }
  }
}

Limites

Cada chave só vê os dados da própria conta — mesmo isolamento da API REST.
120 req/min por chave; criação 10/min e 100/dia; wait_for_email 30/min.
wait_for_email segura até 25s por chamada — sem código no prazo, o agente apenas chama de novo.