Velora

Servidor MCP alojado para comercio argentino — facturación fiscal AFIP en tiempo real + pagos con MercadoPago (en vivo), catálogo, ventas y WhatsApp; un endpoint público sin autenticación expone 9 herramientas de utilidad fiscal.

GitHubPrueba este MCPPatrocinado

Documentación

Este repositorio contiene el manifiesto/documentación pública de un servicio alojado — la implementación completa se ejecuta en producción como parte de Velora.

Velora — MCP de Comercio Argentino

⚠️ El endpoint alojado está temporalmente fuera de línea. El servicio que respalda está en pausa, por lo que tools.somosvelora.com devuelve 404 en este momento — el manifiesto y los contratos de herramientas a continuación siguen siendo precisos, pero las URLs no responderán hasta que vuelva a estar activo. Nada aquí está abandonado; los documentos se mantienen honestos a propósito.

Un kit de herramientas de comercio alojado y de múltiples capacidades para Argentina — facturación real de AFIP, MercadoPago, logística, catálogo y WhatsApp detrás de un único endpoint autenticado.

Velora es un servidor alojado de Model Context Protocol que brinda a los agentes de IA herramientas para operar comercio en Argentina: facturación fiscal (AFIP/ARCA), pagos (MercadoPago), logística (Andreani / PedidosYa), catálogo, caja registradora y mensajería de WhatsApp — autenticado y aislado por tenant.

Existen otros servidores MCP de AFIP (algunos emiten facturas, otros solo buscan en la documentación). El ángulo de Velora es el paquete: lo fiscal es uno de varios rieles de comercio — pagos, logística, catálogo, mensajería — expuestos a través de un único endpoint alojado y autenticado, para que un agente gestione un negocio argentino completo, no solo la facturación.

Endpoint

https://tools.somosvelora.com/api/mcp

Transporte: HTTP transmisible. Autenticación: clave API (HMAC por tenant) o OAuth 2.1 (bearer de WorkOS). Cualquier cliente MCP — Claude, OpenAI, Gemini, Cursor, o tu propio agente — consume el mismo endpoint.

Gratis durante el acceso temprano. Sin costo de uso mientras incorporamos a los primeros desarrolladores — las herramientas fiscales y puras no ejecutan LLM de nuestro lado, por lo que se mantiene barato de mantener abierto.

Conectar

Apunte cualquier cliente MCP que soporte un servidor remoto streamable HTTP al endpoint, con sus credenciales como encabezados:

{
  "mcpServers": {
    "velora": {
      "type": "http",
      "url": "https://tools.somosvelora.com/api/mcp",
      "headers": {
        "X-API-Key": "<your-key>",
        "X-Business-Id": "<your-business-id>"
      }
    }
  }
}

La clave de configuración exacta (type/transport) varía según el cliente — use el formato de servidor MCP remoto/HTTP de su cliente. Solicite acceso en somosvelora.com.

Los ayudantes fiscales puros (validate_cuit, split_iva, y el resto) también están disponibles sin autenticación en https://tools.somosvelora.com/api/mcp/public.

Paquetes de herramientas

Paquete	Qué hace
Fiscal (AFIP/ARCA)	`emit_invoice` (CAE real — Factura A/B/C + Consumidor Final), `consultar_comprobante` / `consultar_padron` (factura + consulta de contribuyente), `get_fiscal_readiness`. `emit_nota` (NC/ND): solo sandbox hoy — la emisión real de notas de crédito/débito está en progreso.
Puro (siempre activo)	`validate_cuit`, `validate_cuil`, `validate_cbu`, `build_afip_qr`, `format_ars`, `to_afip_date`, `split_iva`, `describe_invoice_type`, `parse_ar_amount`
Pagos	Enlaces de MercadoPago, pagos rastreados, estado de intención de pago
Logística	cotizar / crear / rastrear envíos (Andreani, PedidosYa)
Catálogo y Stock	crear / editar / eliminar productos, carga de stock, actualización masiva de precios
Ventas y Caja	registrar ventas, devoluciones, movimientos de caja registradora y saldo
Clientes y Proveedores	encontrar / actualizar clientes, gestión de proveedores
Mensajería	envíos de texto y plantillas de WhatsApp
Reportes	`query_sales` — análisis de ventas
Conexión	`connection_status` — estado de configuración por integración (llame esto primero)

Madurez / qué está en vivo. emit_invoice (Factura A/B/C + Consumidor Final), las herramientas de consulta y las herramientas Puras están verificadas en producción contra AFIP real. emit_nota (NC/ND) actualmente emite solo en sandbox — la emisión real de notas de crédito/débito aún no está conectada (devuelve sandbox: true, nunca un CAE falso). Pagos, Logística y Mensajería son herramientas reales que requieren incorporación de credenciales por tenant (conecte MercadoPago / Andreani / WhatsApp) — hasta que un tenant las conecte, devuelven datos de demostración o fallan con elegancia, así que no las integre en un flujo de producción antes de la incorporación. emit_invoice emite un CAE real solo una vez que la incorporación de ARCA esté completa (verifique con get_fiscal_readiness); de lo contrario, devuelve una respuesta de sandbox claramente marcada (sandbox: true), nunca un CAE falso presentado como real.

Catálogo completo legible por máquina — liste cada herramienta con una llamada tools/list al endpoint público (sin autenticación):

curl -s https://tools.somosvelora.com/api/mcp/public \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Por qué una capa gestionada

Los servicios web de AFIP (WSAA + WSFE) son notoriamente dolorosos: firma CMS PKCS#7 adjunta, handshakes TLS de DH débil, gestión de certificados y tokens por CUIT, y un flujo de nuevas resoluciones (por ejemplo, RG 5616). Velora absorbe todo eso detrás de llamadas de herramientas limpias y nativas para agentes, para que no reimplemente la pila fiscal — la misma razón por la que los desarrolladores recurren a capas gestionadas sobre las APIs de impuestos gubernamentales en otras partes de LATAM.

Estado

✅ Facturación real de AFIP verificada en producción (emisión de CAE en vivo para un tenant incorporado).
✅ Los pagos de MercadoPago y las herramientas puras de validación/formateo están en vivo.
🔧 Logística y mensajería requieren incorporación de credenciales por tenant (ver Madurez arriba).

Enlaces

Sitio: somosvelora.com
Endpoint del toolkit: tools.somosvelora.com
Blog (notas de campo de integración AFIP): somosvelora.com/blog — ⚠️ actualmente devuelve 404 mientras la ruta /blog del sitio está caída

Este repositorio es el manifiesto público y la documentación para el servidor MCP de Velora. El servidor en sí está alojado; este repo contiene el manifiesto de registro server.json y los documentos de conexión.

Construido dirigiendo Claude Code — con alcance, generado y verificado en tiempo de ejecución. El método es el punto — el mismo detrás de 2 correcciones fusionadas en Mastra (framework de agentes de IA en TS de 26k★): #19604, #19610.