# Colombia Invoice MCP

> A remote MCP server that lets any AI agent issue and query Colombia electronic invoices (factura electrónica / factura de venta, DIAN UBL 2.1, modelo de validación previa) through Matias API. Matias is a "Software Propio" provider that generates, digitally signs and transmits the invoice STRAIGHT to the DIAN with NO Proveedor Tecnológico (PT) middleman, from the merchant's own account; this server is a stateless forwarder that also does the local IVA math. Bring-your-own Matias token, never stores anything.

- MCP endpoint (Streamable HTTP): https://inv-co.wishpool.app/mcp
- Credential header: x-matias-token (your Matias bearer token — a JWT access_token from POST /auth/login, or a long-lived Personal Access Token from POST /auth/token). REQUIRED. Optional x-matias-env: sandbox (default = pruebas, no fiscal effect) | production (real DIAN fiscal effect). Optional x-matias-base overrides the production base URL Matias assigns on contract.
- Self-service onboarding: self-register free at matias-api.com (POST /register: first_name, last_name, company_name, email, password, password_confirmation, dni). Registration is on the production URL and credentials auto-replicate to sandbox, so you can integrate against sandbox-api.matias-api.com/api/ubl2.1 before going live. You hold your own DIAN resolución + digital certificate (from a Colombian certification body, on your own DIAN account); Matias signs and transmits with them.
- Money: Colombian pesos (COP, integer convention). Unit prices are TAX-EXCLUSIVE (valor neto, before IVA). IVA rate per line is 19 (standard), 5 (reduced) or 0 (exento/excluido); the IVA is liquidated locally (line net * rate/100) and the UBL totals assembled for you.
- Design: this server ONLY forwards the Matias REST calls (POST /invoice, GET /documents/{uuid}) and does the IVA math. It never signs, never holds the certificate, and never stores credentials.
- Validación previa: the DIAN validates the factura electrónica BEFORE it reaches the buyer and returns the CUFE (Código Único de Facturación Electrónica); create_invoice returns the cufe and state, then query_invoice { uuid } re-checks the live DIAN state.

## Tools

- create_invoice: Issue a Colombia factura de venta (factura electrónica) via POST /invoice. In: resolution_number (your DIAN invoicing resolution), prefix?, number?, customer { dni (NIT/Cédula), company_name, identity_document_id? (6=NIT default, 3=Cédula), email? }, items [{ descripcion, cantidad, precioUnitario (COP integer, tax-exclusive), iva? (19|5|0), codigo?, unidadMedida? }], optional type_document_id (default 1 = Factura de Venta Nacional), operation_type_id (default 10), notes, send_email. Out: cufe (CUFE), is_valid, number, dian_message, totals, tax_breakdown. Matias signs and transmits to the DIAN; this server never signs.
- query_invoice: Look up a document by uuid — GET /documents/{uuid}. Out: uuid, cufe, state, number, dian_message, created_at.
- Owner policy guardrails: x-agentpay-max-amount (hard cap on the invoice grand total in pesos COP), x-agentpay-approval-above (returns an unsubmitted draft for human review), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them.

## Safety

Stateless translation layer that forwards Matias REST calls only. Digital signing and DIAN transmission happen inside the merchant's own Matias account (Software Propio, direct to DIAN, no PT); the Matias token travels per-request in a header and is never stored. This server never stores credentials, invoices, or customer data. Privacy policy: https://inv-co.wishpool.app/privacy

## Sister servers

Invoices: Mexico CFDI https://inv-mx.wishpool.app/mcp, Brazil NF-e https://inv-br.wishpool.app/mcp, Chile DTE https://inv-cl.wishpool.app/mcp, Peru CPE https://inv-pe.wishpool.app/mcp, Argentina AFIP https://inv-ar.wishpool.app/mcp, Costa Rica Hacienda https://inv-cr.wishpool.app/mcp, Ecuador SRI https://inv-ec.wishpool.app/mcp, Paraguay SIFEN https://inv-py.wishpool.app/mcp, Saudi ZATCA https://inv-sa.wishpool.app/mcp, India GST https://inv-in.wishpool.app/mcp, Poland KSeF https://inv-pl.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). Logistics & shipping: https://logi.wishpool.app.