# Uruguay Invoice MCP

> A remote MCP server that lets any AI agent submit Uruguay DGI e-Factura (Comprobante Fiscal Electrónico, CFE) documents to the DGI facturación electrónica webservice. It wraps the submission calls only: the CFE signature, the Sobre signature and the WS-Security SOAP signature all stay merchant-side. Stateless, bring-your-own Uruguayan CA certificate, never stores anything.

- MCP endpoint (Streamable HTTP): https://inv-uy.wishpool.app/mcp
- No API credential is sent to this server. DGI requires message-level WS-Security, so you sign the CFE, build + sign the Sobre, and X.509-sign the SOAP envelope with your Uruguayan CA certificate (e.g. Correo Uruguayo) — all merchant-side. You pass the finished signed SOAP envelope (base64) and this server forwards it to DGI. Your private key never leaves your side.
- Endpoint header: x-dgi-mode: test (default, ePrueba sandbox — no fiscal effect, verified live) | homologacion | produccion; or x-dgi-endpoint to point at an explicit DGI webservice URL.
- Design: this server ONLY forwards the DGI submission calls. It adds the SOAPAction header, POSTs your signed envelope, and translates the DGI acknowledgement (estado AS = Sobre Recibido / accepted, BS = Sobre Rechazado / rejected; motivos_rechazo on rejection; consulta_token + consulta_fechahora for the 2nd message). It never signs and never stores documents or keys.
- Operations wrapped (SOAP 1.1, namespace http://dgi.gub.uy): EFACRECEPCIONSOBRE (submit_sobre), EFACRECEPCIONREPORTE (submit_reporte_diario), EFACCONSULTARESTADOENVIO (query_envio_status). Verified live 2026-07-10: GET .../ePrueba/ws_eprueba?wsdl = 200; an unsigned POST is rejected with a DGI-signed SOAP Fault "No signature in message!".
- Registro de Proveedor Habilitado is NOT required: that is DGI's optional simplified-onboarding scheme for commercial software vendors (needs 5+ issuer declarations + software-vendor activity codes). A merchant issuing its own CFEs onboards via the standard ingreso al régimen as an emisor electrónico with its own software.

## Tools

- submit_sobre: Submit a Sobre (envelope of signed CFEs — e-Factura / e-Ticket + notas) to DGI (EFACRECEPCIONSOBRE). Input = signed_soap_envelope (base64 WS-Security-signed SOAP). Output = estado AS/BS + motivos_rechazo + consulta_token/consulta_fechahora. Signing stays merchant-side.
- submit_reporte_diario: Submit the mandatory Reporte Diario (EFACRECEPCIONREPORTE). Same signed-envelope input; returns the DGI acknowledgement.
- query_envio_status: Query a submission status / fetch the 2nd message (EFACCONSULTARESTADOENVIO) using a signed consulta envelope; returns the DGI response document. Read-only at DGI.
- build_cfe_envelope: Local helper (no network, no signing). Wraps your signed inner XML (Sobre / Reporte / consulta) into the exact SOAP Body to WS-Security-sign before submitting.
- calc_iva: Local helper (no network). Computes CFE MontosTotales from line items — IVA Tasa Básica 22% / Tasa Mínima 10% / Exento — returns MntNetoIvaTasaBasica, MntNetoIvaTasaMin, MntExento, MntIVATasaBasica, MntIVATasaMin, MntTotal.
- get_dgi_info: Local reference. DGI endpoints, the three operations + SOAPActions, CFE document types (TipoCFE), IVA rates and namespaces.
- Owner policy guardrail: x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax it.

## Safety

Stateless forwarder that relays the DGI submission calls only. The CFE signature, the Sobre signature and the WS-Security SOAP signature stay merchant-side; the signed envelope travels per-request and is never stored. This server never stores credentials, documents, or customer data. Privacy policy: https://inv-uy.wishpool.app/privacy

## Sister servers

Invoices: Saudi ZATCA https://inv-sa.wishpool.app/mcp, Chile DTE https://inv-cl.wishpool.app/mcp, Mexico CFDI 4.0 https://inv-mx.wishpool.app/mcp, Peru CPE https://inv-pe.wishpool.app/mcp, Brazil NF-e https://inv-br.wishpool.app/mcp, India GST e-invoicing https://inv-in.wishpool.app/mcp. Same stateless BYO pattern, local payments in 81 countries — full list: https://mcp.wishpool.app/llms.txt (Taiwan e-invoice 電子發票 lives in https://mcp.wishpool.app/mcp).