# Nota Fiscal — how to use (mcp.ai)

Emita e gerencie notas fiscais de serviço (NFS-e) conversando com o agente, hospedado pela plataforma, sem você precisar de conta na nfe.io. Conecte seu CNPJ + certificado A1 e emita, consulte, baixe (PDF/XML) e cancele NFS-e.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_notafiscal?ms=1781045340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `notafiscal_baixar_nfse`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/notafiscal`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/notafiscal/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/notafiscal/baixar/nfse` — Retorna os links de PDF (DANFSe) e XML de uma NFS-e emitida.
  - body: { company?: string, invoice_id: string, invoice_ids?: string[] }
- `POST https://api.mcp.ai/api/notafiscal/cancelar/nfse` — Cancela uma NFS-e emitida (IRREVERSÍVEL, sujeito ao prazo de cancelamento do município). Confirme antes de chamar.
  - body: { company?: string, invoice_id: string, invoice_ids?: string[] }
- `POST https://api.mcp.ai/api/notafiscal/consultar/nfse` — Consulta o status/detalhe de uma NFS-e emitida, por invoice_id.
  - body: { company?: string, invoice_id: string, invoice_ids?: string[] }
- `POST https://api.mcp.ai/api/notafiscal/emitir/nfse` — Emite uma NFS-e (nota fiscal de serviço) para uma empresa conectada.
  - body: { company?: string, nfse: string, external_id?: string, external_ids?: string[] }
- `POST https://api.mcp.ai/api/notafiscal/empresas` — Lista as empresas (CNPJs) conectadas a este install e a situação de cada uma (company_id, razão social, município, validade do certificado).
- `POST https://api.mcp.ai/api/notafiscal/listar/nfse` — Lista as NFS-e emitidas por uma empresa (paginado).
  - body: { company?: string, page_count?: number, page_index?: number }

## Example prompts
- "Emita uma NFS-e de R$1.500 de consultoria para o CNPJ do cliente X"
- "Liste as últimas NFS-e que emiti este mês"
- "Baixe o PDF e o XML da nota XYZ"

## More
- Page: https://mcp.ai/notafiscal
- Agent spec (llms.txt): https://mcp.ai/notafiscal/llms.txt
- Postman collection: https://mcp.ai/notafiscal/postman.json