# Velora Toolkit > Servidor MCP (Model Context Protocol) que expone 60 herramientas de negocio > argentino — fiscal, pagos, logística, ventas, caja, clientes, proveedores > y comunicaciones — a cualquier agente de IA (61 totales; connect_tiendanube > solo activo cuando TIENDANUBE_CLIENT_ID y TIENDANUBE_CLIENT_SECRET presentes). > Conexión máquina a máquina (stateless Streamable HTTP). ## Endpoints **Público (sin autenticación):** `https://tools.somosvelora.com/api/mcp/public` Todas las herramientas puras (9 tools). Sin credenciales. Rate limit: 60 req/min por IP. **Con autenticación (tenant):** `https://tools.somosvelora.com/api/mcp` Todas las herramientas. Requiere credenciales por tenant (HMAC o OAuth 2.1 Bearer). ## Conexión (endpoint autenticado) Claude Code (y cualquier cliente que soporte headers HTTP) se autentica enviando `x-api-key` (clave de API por tenant) y `x-business-id` (identificador del negocio) en cada request. Los clientes MCP alojados (Cowork, Claude Desktop, claude.ai) se conectan mediante OAuth 2.1: el cliente descubre el authorization server en `/.well-known/oauth-protected-resource` (RFC 9728), el usuario autoriza una vez, y el cliente envía el access token en `Authorization: Bearer ` en cada request. ## Tools ### Puras (siempre activas — disponibles en ambos endpoints) - [validate_cuit](https://tools.somosvelora.com/api/mcp/public): Valida CUIT/CUIL y retorna tipo de persona. - [build_afip_qr](https://tools.somosvelora.com/api/mcp/public): Construye la URL QR AFIP per RG 4291/2018 a partir de los campos de la factura. - [parse_ar_amount](https://tools.somosvelora.com/api/mcp/public): Parsea monto en formato argentino ("$1.234,56", "5k") a número. Usar antes de operar montos textuales. - [split_iva](https://tools.somosvelora.com/api/mcp/public): Descompone monto en neto + IVA para cualquiera de las 6 alícuotas ARCA/WSFE. - [validate_cuil](https://tools.somosvelora.com/api/mcp/public): Valida CUIL para personas físicas; advierte si el prefijo corresponde a empresa. - [format_ars](https://tools.somosvelora.com/api/mcp/public): Formatea número como ARS con 2 decimales (1500.5 → "$1.500,50"). - [to_afip_date](https://tools.somosvelora.com/api/mcp/public): Convierte fecha ISO a YYYYMMDD para WSFE, anclado en ART (UTC-3). - [describe_invoice_type](https://tools.somosvelora.com/api/mcp/public): Retorna tipo A/B/C según condición IVA del emisor y receptor. - [validate_cbu](https://tools.somosvelora.com/api/mcp/public): Valida CBU/CVU argentino (22 dígitos) por dígitos verificadores BCRA Com. A 2622. ### Fiscal (ARCA) - [get_fiscal_readiness](https://tools.somosvelora.com): Verifica si el negocio puede emitir facturas reales ante ARCA. - [emit_invoice](https://tools.somosvelora.com): Emite factura electrónica ante ARCA y retorna CAE. - [emit_nota](https://tools.somosvelora.com): Simula una nota de crédito o débito en sandbox. La emisión real de NC/ND ante ARCA todavía no está soportada por esta vía (el path real la rechaza). - [consultar_comprobante](https://tools.somosvelora.com): Verifica y recupera datos de un comprobante emitido ante ARCA (solo lectura). - [consultar_padron](https://tools.somosvelora.com): Consulta datos de contribuyente en el padrón AFIP Scope 4 por CUIT (solo lectura). ### Pagos - [get_payment_intent_status](https://tools.somosvelora.com): Estado de PaymentIntent unificado por ID o nombre de cliente. ### Logística - [quote_shipping](https://tools.somosvelora.com): Cotiza tarifas de todos los couriers activos del negocio. - [create_shipment](https://tools.somosvelora.com): Crea envío con el courier elegido y retorna número de seguimiento. - [track_shipment](https://tools.somosvelora.com): Consulta estado e historial de un envío por tracking number. - [get_package_profile](https://tools.somosvelora.com): Calcula peso y dimensiones de un paquete desde saleId o productos. ### Catálogo & Stock (lectura) - [query_catalog](https://tools.somosvelora.com): Lista productos activos del catálogo; filtra por nombre. Incluye stock por producto. - [query_sales](https://tools.somosvelora.com): Consulta métricas de ventas: ingresos, margen, ranking, por empleado o historial de cliente. ### Catálogo & Stock (escritura) - [create_product](https://tools.somosvelora.com): Crea un nuevo producto en el catálogo. - [edit_product](https://tools.somosvelora.com): Edita nombre, precio o stock de un producto existente. - [delete_product](https://tools.somosvelora.com): Elimina o archiva un producto del catálogo. - [stock_load](https://tools.somosvelora.com): Registra ingreso de mercadería desde proveedor. - [adjust_stock](https://tools.somosvelora.com): Ajuste absoluto de inventario (set, race-safe). - [bulk_price_update](https://tools.somosvelora.com): Actualización masiva de precios por porcentaje, monto fijo o valor exacto. ### Ventas & Caja - [register_sale](https://tools.somosvelora.com): Registra venta completa con items, cliente y método de pago. - [register_movement](https://tools.somosvelora.com): Registra movimiento de caja (ingreso, egreso, impuesto, sueldo). - [register_promesa_sale](https://tools.somosvelora.com): Registra venta con pago diferido (promesa / cuentas a cobrar). - [confirm_promesa_payment](https://tools.somosvelora.com): Marca un PaymentIntent existente como promesa de pago. - [settle_promesa_payment](https://tools.somosvelora.com): Registra el cobro efectivo de una promesa previa. - [return_sale](https://tools.somosvelora.com): Revierte las N ventas más recientes (restaura stock y caja). ### Caja - [caja_consultar_saldo](https://tools.somosvelora.com): Consulta saldo y estado actual de la caja (turno abierto o último cierre). - [caja_ciclo_caja](https://tools.somosvelora.com): Abre o cierra un turno de caja con fondo inicial o conteo final. - [caja_registrar_movimiento](https://tools.somosvelora.com): Registra movimiento de caja: ingreso, gasto, retiro, impuesto o sueldo. ### Clientes - [find_customer](https://tools.somosvelora.com): Busca clientes por nombre o teléfono (substring, case-insensitive). - [upsert_customer](https://tools.somosvelora.com): Crea o actualiza un cliente; upsert por teléfono. - [delete_customer](https://tools.somosvelora.com): Elimina un cliente (bloqueado si tiene historial de ventas). ### Proveedores - [list_suppliers](https://tools.somosvelora.com): Lista todos los proveedores del negocio; filtra por nombre. - [create_supplier](https://tools.somosvelora.com): Crea un proveedor; idempotente por nombre. - [edit_supplier](https://tools.somosvelora.com): Actualiza datos de un proveedor existente. - [delete_supplier](https://tools.somosvelora.com): Elimina un proveedor con trazabilidad de auditoría. - [create_purchase_request](https://tools.somosvelora.com): Genera una solicitud de compra a un proveedor. ### Comunicaciones - [send_whatsapp_text](https://tools.somosvelora.com): Envía mensaje de texto libre por WhatsApp (ventana 24 h). - [send_whatsapp_template](https://tools.somosvelora.com): Envía plantilla Meta aprobada, sin restricción de ventana. ### Conexiones & Onboarding - [connection_status](https://tools.somosvelora.com): Retorna el estado de cada integración BYOA (fiscal, pagos, envíos, WhatsApp, SMS, email) con guía para conectar las que faltan.