# Cobra

> Cobra es un punto de venta (POS) y sistema de facturación electrónica del SRI para Ecuador. Ofrece una API REST y el primer servidor MCP (Model Context Protocol) de facturación electrónica del SRI ecuatoriano, para que negocios y agentes de IA emitan facturas, notas de venta, notas de crédito/débito y retenciones autorizadas por el SRI en tiempo real. Producto de Motivando LLC.

## Contexto
- Desde el 1 de enero de 2026 todo contribuyente del Ecuador —incluidos RIMPE y negocios populares con nota de venta electrónica— debe transmitir sus comprobantes al SRI en tiempo real. Cobra emite y obtiene la autorización en el momento.
- La firma electrónica (certificado .p12), la clave de acceso y la comunicación con el SRI las maneja Cobra; el integrador solo hace llamadas REST o usa el MCP.

## Desarrolladores
- [API REST de facturación](https://facturacobra.com/api): Emite facturas, notas de venta y retenciones del SRI con una llamada REST. Autenticación por llave Bearer, sandbox de pruebas, webhooks firmados HMAC.
- [Servidor MCP](https://facturacobra.com/mcp): Conecta Claude, ChatGPT, Cursor o cualquier agente de IA al SRI de Ecuador para facturar con lenguaje natural. Endpoint: https://facturacobra.com/mcp (Streamable HTTP, auth Bearer mfact_).
- [Documentación OpenAPI (Redoc)](https://facturacobra.com/api/v1/docs): Referencia interactiva de todos los endpoints.
- [Especificación OpenAPI (JSON)](https://facturacobra.com/api/v1/openapi.json): Contrato máquina-legible de la API.

## Empezar
- [Crear cuenta gratis](https://facturacobra.com/pos/?registro=1): Registro para obtener una llave de API. Luego: Config → Desarrolladores → Nueva llave.
- [Ingresar al POS](https://facturacobra.com/pos/): Punto de venta con facturación electrónica.
<!-- cobra:restaurantes -->- [Cobra para restaurantes](https://facturacobra.com/restaurantes/): Modo salón para restaurantes, cafeterías y bares: mesas que se ven en todos los celulares, comanda a cocina en pantalla, la cocina marca cuando sale, dividir cuenta por plato, propina en la mesa, para llevar y delivery con precio por app, pin por persona, pantalla para el cliente en la caja, ingredientes que se descuentan solos (plan Sucursal).<!-- /cobra:restaurantes -->

<!-- cobra:planes -->
## Planes
- Barrio (gratis): 1 caja; 100 ventas al mes; POS completo + factura SRI; Productos ilimitados y reportes para tu contador; «Hecho con Cobra» en tu factura.
- Sucursal ($12/mes o $120/año): Ventas ILIMITADAS; Cajas ilimitadas; Recetas: los ingredientes se descuentan solos al vender; Tu logo en la factura; Soporte por correo el mismo día.
- Cadena ($35/mes o $350/año): Todo lo de Sucursal; Hasta 5 locales; Consolidado de tus locales: ventas, IVA, cierres de caja y lo más vendido, en Excel; ¿Más de 5 locales? Hablemos.
<!-- /cobra:planes -->

## Herramientas del MCP
- emitir_factura: emite una factura (01) y obtiene autorización del SRI.
- emitir_documento: nota de crédito (04), nota de débito (05) o retención.
- consultar_ruc: valida un RUC/cédula en el catastro del SRI.
- consultar_estado: estado de autorización de un comprobante.
- listar_documentos: lista comprobantes emitidos con filtros.
- anular_documento: guía la anulación según reglas del SRI (plazo día 7 del mes siguiente; consumidor final no anulable desde 2026).
- crear_contacto / crear_producto: alta de clientes y productos.
- whoami: negocio, permisos y ambiente de la llave.