klodr/faxdrop-mcp

O que faxdrop-mcp faz?

Envie faxes reais de qualquer assistente de IA habilitado para MCP. Encapsula a API FaxDrop (PDF/DOCX/JPG/PNG, números internacionais, monitoramento de status) com limites de taxa, modo de simulação e registro de auditoria.

Funcionalidades

• Envio de Fax Real: Converte documentos PDF, DOCX, JPG e PNG em faxes enviados para números de telefone nacionais e internacionais.
• Monitoramento de Status: Acompanhe o status do envio em tempo real, incluindo confirmações de entrega.
• Limites de Taxa: Evite uso excessivo com limites configuráveis de requisições por minuto.
• Modo de Simulação (Dry-Run): Teste o fluxo de envio sem consumir créditos ou enviar faxes reais.
• Registro de Auditoria: Mantenha um log detalhado de todas as operações realizadas, útil para depuração e compliance.

Pré-requisitos

• Uma chave de API para o serviço FaxDrop. Obtenha uma em faxdrop.com.
• Um assistente de IA que suporte o protocolo MCP, como Claude Code, Cursor, Codex, ou semelhantes.

Configuração

Configure as seguintes variáveis de ambiente no seu assistente MCP:

# Obrigatório
export FAXDROP_API_KEY="sua_chave_api_aqui"

# Opcional
export FAXDROP_RATE_LIMIT=10          # Limite de requisições por minuto (padrão: 10)
export FAXDROP_DRY_RUN=false          # Modo de simulação (padrão: false)
export FAXDROP_AUDIT_LOG="/caminho/para/audit.log"

Ou, se estiver usando um arquivo de configuração MCP (ex.: mcp.json), adicione:

{
  "mcpServers": {
    "faxdrop": {
      "command": "npx",
      "args": ["-y", "@klodr/faxdrop-mcp"],
      "env": {
        "FAXDROP_API_KEY": "sua_chave_api_aqui",
        "FAXDROP_RATE_LIMIT": "10",
        "FAXDROP_DRY_RUN": "false",
        "FAXDROP_AUDIT_LOG": "/caminho/para/audit.log"
      }
    }
  }
}

Uso

Após configurado, você pode enviar faxes com comandos como:

Envie o documento "contrato.pdf" para o número +1 555 123 4567.

O assistente interpretará a solicitação e usará a ferramenta faxdrop_send com os parâmetros apropriados.

Parâmetros da Ferramenta

Parâmetro	Tipo	Obrigatório	Descrição
filePath	string	Sim	Caminho para o arquivo a ser enviado.
recipient	string	Sim	Número de fax do destinatário (formato E.164).
sender	string	Não	Nome do remetente (opcional).
dryRun	bool	Não	Sobrescreve a configuração de ambiente.

Exemplo de Resposta

{
  "success": true,
  "faxId": "fax_abc123",
  "status": "queued",
  "estimatedPages": 3,
  "cost": 0.15
}

Limitações

• O formato do número deve seguir o padrão E.164 (ex.: +15551234567).
• O tamanho máximo do arquivo é de 10 MB.
• Consulte a documentação da API FaxDrop para detalhes sobre formatos suportados e cobertura internacional.

Licença

MIT