@notaas/mcp
v0.2.2
Published
Official Model Context Protocol (MCP) Server for Notaas Fiscal Platform (NFS-e, NF-e, NFC-e, CT-e, MDF-e & Reforma Tributária IBS/CBS)
Maintainers
Readme
@notaas/mcp — Official Notaas MCP Server
O Notaas MCP Server (@notaas/mcp) conecta assistentes de IA (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, ChatGPT Connectors, n8n, LangGraph) diretamente à infraestrutura fiscal full-stack da Notaas Platform:
- 5 Ferramentas Gratuitas de Inteligência Tributária (Zero API Key / PLG):
notaas_check_city_coverage— Consulta cobertura e engine de 5.570 municípios brasileiros;notaas_lookup_tax_codes— ConsultacTribNac(LC 116) e desdobros municipaiscTribMun;notaas_validate_access_key— Valida (Módulo 11) e decodifica chaves de 44 dígitos (SEFAZ) e 50 dígitos (NFS-e Nacional);notaas_validate_cpf_cnpj— Valida CPF e CNPJ (numérico e alfanumérico);notaas_explain_ibs_cbs_reference— Referência técnica deCST,cClassTribe cálculo demonstrativo da Reforma Tributária (IBS/CBS — LC 214/2025).
- NFS-e (23+ Engines Municipais + Padrão Nacional ADN):
nfse_emit,nfse_emit_batch,nfse_get_status,nfse_get_batch_status,nfse_cancel,nfse_diagnose_error. - NF-e (Modelo 55) & NFC-e (Modelo 65):
nfe_emit,nfe_get_status,nfe_cancel,nfe_send_carta_correcao,nfe_inutilizar_numeracao. - CT-e 4.00 (Modelo 57) & MDF-e 3.00b (Modelo 58):
cte_emit,cte_get_status,cte_cancel,cte_averbar,mdfe_emit,mdfe_get_status,mdfe_encerrar,mdfe_cancel,mdfe_list_open_alerts. - White-Label Multi-Tenant (
ntaas_org_*) & Webhooks:org_list_projects,org_get_project,org_create_project,org_update_project,org_list_project_api_keys,org_create_project_api_key,org_get_settings,webhooks_list_endpoints,webhooks_list_deliveries,webhooks_test_endpoint. - Agentic Onboarding (v0.2.0 — "Zero to First Invoice"):
- Device Flow de Conta (público; indisponível em modo somente-leitura):
notaas_start_account_onboarding,notaas_claim_account_onboarding— criação/conexão de conta sem sair do assistente, com token de bootstrap de 24h; - Onboarding de Projeto:
org_get_project_certificate_status,org_create_certificate_upload_session(Cenários 2 e 3: comandoread -sno terminal ou link Dropzone sem login/onboarding/cert#token=...),org_upload_project_certificate(Cenário 1: referência local Zero-Trust nostdioviapfxFilePath+passwordEnvVar/passwordFilePath; Cenário 4:pfxBase64+password),org_get_project_numbering,org_configure_project_numbering,org_upload_project_logo,org_check_project_readiness,webhooks_create_endpoint,org_revoke_onboarding_token; - Prompt guiado
onboard-new-companycom o roteiro completo em PT-BR por persona (incluindo as 4 opções de envio do Certificado A1 e aprovação humana antes da primeira emissão).
- Device Flow de Conta (público; indisponível em modo somente-leitura):
Total: 46 tools + Resources + Prompts.
Como Conectar
Opção 1 — Remote MCP Server (Zero Instalação / Streamable HTTP)
URL oficial:
https://platform.notaas.com.br/api/mcpNo Cursor / Claude Code / Windsurf (mcp.json):
{
"mcpServers": {
"notaas": {
"url": "https://platform.notaas.com.br/api/mcp",
"headers": {
"x-api-key": "ntaas_sua_project_key_ou_ntaas_org_token"
}
}
}
}Opção 2 — Execução Local via npx (stdio)
{
"mcpServers": {
"notaas": {
"command": "npx",
"args": ["-y", "@notaas/mcp"],
"env": {
"NOTAAS_API_KEY": "ntaas_sua_project_key_ou_ntaas_org_token"
}
}
}
}Modo Somente-Leitura (Auditoria / Suporte): Adicione
"NOTAAS_MCP_READ_ONLY": "true"emenv(ou o header"x-mcp-readonly": "true"no Remote MCP) para desabilitar todas as ferramentas de emissão/cancelamento/escrita. Nesse modo, as tools públicas do Device Flow de onboarding (notaas_start_account_onboardingenotaas_claim_account_onboarding) também NÃO são registradas, pois criam sessões de pareamento e entregam/consomem credenciais (operações de estado/escrita).
