@engineapi/mcp-server

MCP Server oficial do EngineAPI — Emissão fiscal para agentes AI (NFe, NFSe, CTe, MDFe)

Permite que agentes AI como Claude, Cursor e outros clientes MCP emitam notas fiscais, consultem documentos e verifiquem emissores diretamente — usando sua API Key do EngineAPI.

🚀 Início Rápido

Claude Desktop

Edite ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "engineapi": {
      "command": "npx",
      "args": ["@engineapi/mcp-server"],
      "env": {
        "ENGINEAPI_KEY": "ek_live_sua_chave_aqui"
      }
    }
  }
}

Reinicie o Claude Desktop e peça:

"Emita uma NFSe de R$ 2.500 para o CNPJ 12.345.678/0001-90, serviço de consultoria"

Cursor

Edite .cursor/mcp.json na raiz do projeto:

{
  "mcpServers": {
    "engineapi": {
      "command": "npx",
      "args": ["@engineapi/mcp-server"],
      "env": {
        "ENGINEAPI_KEY": "ek_live_sua_chave_aqui"
      }
    }
  }
}

🔑 Obter sua API Key

1. Acesse app.engineapi.com.br
2. Vá em Configurações → API Keys
3. Copie sua chave (formato ek_live_...)

🛠️ Tools Disponíveis (10)

| Tool | Descrição | |------|-----------| | emitir_nfe | Emite NFe (Modelo 55) | | emitir_nfse | Emite NFSe de prestação de serviços | | emitir_cte | Emite CTe (Conhecimento de Transporte) | | emitir_mdfe | Emite MDFe (Manifesto de Documentos) | | listar_notas | Lista documentos com filtros (status, período, tipo) | | consultar_status | Status detalhado de um documento por ID ou chave | | cancelar_nota | Cancela nota autorizada com justificativa | | listar_emissores | Lista emissores (CNPJs) cadastrados | | consultar_cnpj | Consulta dados na Receita Federal | | status_sefaz | Disponibilidade dos serviços SEFAZ por UF |

⚙️ Modo HTTP+SSE (avançado)

Para integrar via HTTP (n8n, Make.com, Claude.ai web):

ENGINEAPI_KEY=ek_live_xxx npx @engineapi/mcp-server --http --port 3015

Endpoints:

• GET /health → status do servidor
• GET /sse → stream SSE (MCP transport)
• POST /messages → mensagens MCP

🌍 Variáveis de Ambiente

| Variável | Obrigatório | Descrição | |----------|-------------|-----------| | ENGINEAPI_KEY | ✅ Sim | Sua API Key (ek_live_...) | | ENGINEAPI_BASE_URL | Não | Override da URL da API (default: https://api.engineapi.com.br/v1) | | MCP_CORS_ORIGINS | Não | Origens CORS permitidas no modo HTTP (default: *) |

📚 Documentação

• Guia completo
• Referência dos tools
• Dashboard

📄 Licença

MIT — © EngineAPI / 3X Tecnologia