Veriko changelog

description

Valida y consulta transferencias SPEI mediante la API oficial de Veriko. → Verify Mexican SPEI transfers against the Banxico CEP and operate the Veriko public API.

env_vars

VERIKO_API_KEY, VERIKO_MCP_PROFILE, VERIKO_MCP_MAX_RISK → VERIKO_API_KEY, VERIKO_MCP_PROFILE, VERIKO_MCP_MAX_RISK, VERIKO_BASE_URL, VERIKO_TIMEOUT_MS, VERIKO_MAX_RETRIES, VERIKO_ACCEPT_LANGUAGE, VERIKO_MCP_FILE_ROOTS

version

0.1.14 → 0.2.0

website_url

https://docs.veriko.mx → https://docs.veriko.mx/en/mcp

version

0.1.13 → 0.1.14

version

0.1.12 → 0.1.13

file

published → removed

https://raw.githubusercontent.com/veriko-mx-labs/veriko-mcp/HEAD/AGENTS.md

− # AGENTS.md — Veriko MCP− Reglas para cualquier agente que trabaje en este repositorio:− 1. El SDK oficial de JavaScript es la única capa de transporte hacia la API y−    se importa mediante el alias estable `@veriko-mx/sdk-runtime`. No dupliques−    HTTP, autenticación, reintentos, polling, descargas ni errores.− 2. La superficie es exactamente la pública M2M del spec.− 3. Todo `operationId` soportado por el SDK debe tener un adaptador en−    `src/catalog.ts`. `known_gaps` no es una solución permanente. La única−    excepción es `NOT_EXPOSED_OPERATIONS`: el borrado definitivo de una−    validación no se anuncia, porque no se puede deshacer.− 4. La clave de API sólo entra por `VERIKO_API_KEY`. Nunca es argumento de herramienta,−    log, fixture, error, ejemplo real ni metadato MCP.− 5. Descargas y binarios se entregan como recursos MCP. No escribas en el−    workspace ni metas base64 en contenido textual.− 6. Mantén separadas la selección por perfil y la política de riesgo.− 7. Conserva la idempotencia determinista y versionada. Para binarios se resume−    el contenido, nunca una ruta local.− 8. Las pruebas usan un SDK falso o recordings sanitizados; nunca la API real.− 9. Antes de empujar: `npm run check`, `npm run check:surface` y `npm pack --dry-run`.− 10. No publiques npm, tags o el MCP Registry sin aprobación explícita y CI verde.

version

0.1.11 → 0.1.12

https://docs.veriko.mx/llms.txt

− - [Paginación](https://docs.veriko.mx/es/concepts/pagination): Los dos estilos de paginación de la API y cuándo aparece cada uno.− - [Pagination](https://docs.veriko.mx/en/concepts/pagination): The API's two pagination styles and where each one appears.+ - [Paginación](https://docs.veriko.mx/es/concepts/pagination): El estilo de paginación de la API y dónde aparece.+ - [Pagination](https://docs.veriko.mx/en/concepts/pagination): The API's pagination style and where it appears.

version

0.1.10 → 0.1.11

https://docs.veriko.mx/llms.txt

− - [Inspeccionar tu perfil de cuenta](https://docs.veriko.mx/es/how-to/inspect-my-account): Recupera el perfil completo de la cuenta autenticada en una sola llamada: datos de usuario, suscripción activa, cuotas y estado de verificación.− - [Iniciar importación masiva de beneficiarios](https://docs.veriko.mx/es/v1/beneficiaries/create-beneficiary-import): Sube un archivo (CSV, XLS, XLSX, TXT o PDF) de hasta 20 MB y abre con él un trabajo de importación. Las hojas XLSX/XLS admiten hasta 10 000 filas y 64 columnas. Las fórmulas XLSX se leen como texto, sin ejecutarlas. Los PDF admiten hasta 50 páginas y limitan a 8 MiB la descompresión de cada flujo.− - [Descargar la plantilla de importación de beneficiarios](https://docs.veriko.mx/es/v1/beneficiaries/download-beneficiary-import-template): Devuelve un archivo plantilla para la importación de beneficiarios en el formato solicitado, con encabezados en español o inglés y filas de ejemplo para CLABE, tarjeta y celular/DiMo. Sirve de punto de partida para la importación masiva.− - [Exportar los beneficiarios de la cuenta de usuario](https://docs.veriko.mx/es/v1/beneficiaries/export-beneficiaries): Descarga las cuentas beneficiarias del usuario autenticado como archivo, usa el mismo filtro with_archived que GET /v1/beneficiaries/list-beneficiaries.− - [Obtener el resumen del panel](https://docs.veriko.mx/es/v1/dashboard/get-dashboard-summary): Devuelve los contadores agregados del usuario: el total histórico, el total del mes UTC en curso, las validaciones con veredicto valid, el contador mensual de los estados pending y processing, el monto promedio y la tasa de éxito. Incluye también la cantidad de beneficiarios activos.− - [Desglosar consumo por operación](https://docs.veriko.mx/es/v1/usage/get-usage-breakdown): Desglosa el consumo del periodo indicado por tipo de operación contabilizada (validation, validation_ocr, etc.).− - [Consultar índices de consumo mes a mes](https://docs.veriko.mx/es/v1/usage/get-usage-history): Devuelve el consumo mensual de validaciones del usuario autenticado en los últimos months meses, de más reciente a más antiguo.− - [Descargar el CEP oficial](https://docs.veriko.mx/es/v1/validations/download-cep): Descarga el Comprobante Electrónico de Pago (CEP) emitido por Banxico de una validación con veredicto valid.− - [Exportar todas las entregas webhook como CSV o XLSX](https://docs.veriko.mx/es/v1/webhooks/export-all-deliveries): Descarga el historial de entregas de todos los endpoints de la cuenta de usuario en un archivo, con los mismos filtros que el listado: endpoint, estado y tipo de evento.− - [Inspect your account profile](https://docs.veriko.mx/en/how-to/inspect-my-account): Retrieve the complete profile for the authenticated account in a single call: user data, active subscription, quotas, and verification status.− - [Start a bulk beneficiary import](https://docs.veriko.mx/en/v1/beneficiaries/create-beneficiary-import): Uploads a file — CSV, XLS, XLSX, TXT, or PDF, up to 20 MB — and opens an import job with it. XLSX/XLS sheets allow up to 10,000 rows and 64 columns. XLSX formulas are read as text without evaluation. PDFs allow up to 50 pages and cap decoded streams at 8 MiB. The reading mode decides how much work the file does and how much the server does:− - [Download bulk import template](https://docs.veriko.mx/en/v1/beneficiaries/download-beneficiary-import-template): Returns a template file in the requested format, with headers in Spanish or English and example rows for CLABE, card and DiMo phone. Serves as a starting point for the bulk import.− - [Export beneficiaries as CSV](https://docs.veriko.mx/en/v1/beneficiaries/export-beneficiaries): Downloads the beneficiary accounts of the authenticated account as a file, under the same with_archived filter as GET /v1/beneficiaries/list-beneficiaries.− - [Get dashboard summary](https://docs.veriko.mx/en/v1/dashboard/get-dashboard-summary): Returns the user's aggregate counters: the lifetime total, the current UTC-month total, validations with verdict valid, the monthly count of the pending and processing states, the average amount, and the success rate. It also includes the active beneficiary count.− - [Usage breakdown by operation](https://docs.veriko.mx/en/v1/usage/get-usage-breakdown): Breaks down the indicated period's usage by billable operation type (validation, validation_ocr, etc.).− - [Monthly usage history](https://docs.veriko.mx/en/v1/usage/get-usage-history): Returns the authenticated user's monthly validation usage over the last months months, most recent first.− - [Download the official CEP](https://docs.veriko.mx/en/v1/validations/download-cep): Downloads the Electronic Payment Receipt (CEP) issued by Banxico for a validation with a valid verdict.− - [Export all deliveries as CSV or XLSX](https://docs.veriko.mx/en/v1/webhooks/export-all-deliveries): Downloads the delivery history of every endpoint on the account as a file, under the same filters as the list: endpoint, status, and event type.− - [List deliveries across all endpoints](https://docs.veriko.mx/en/v1/webhooks/list-all-deliveries): Consolidated view of the authenticated user's webhook deliveries, across all their endpoints at once. It can be filtered by endpoint, status, and event type.+ - [Inspeccionar tu perfil de cuenta](https://docs.veriko.mx/es/how-to/inspect-my-account): Recupera el perfil completo de la cuenta autenticada en una sola llamada: datos de usuario, suscripción activa y estado de verificación.+ - [Iniciar importación masiva de beneficiarios](https://docs.veriko.mx/es/v1/beneficiaries/create-beneficiary-import): Sube un archivo (CSV, XLS, XLSX, TXT, JSON o PDF) de hasta 20 MB y abre con él un trabajo de importación. Las hojas XLSX/XLS admiten hasta 10 000 filas y 64 columnas. Las fórmulas XLSX se leen como texto, sin ejecutarlas. Los PDF admiten hasta 50 páginas y limitan a 8 MiB la descompresión de cada flujo.+ - [Descargar la plantilla de importación de beneficiarios](https://docs.veriko.mx/es/v1/beneficiaries/download-beneficiary-import-template): Devuelve un archivo plantilla para la importación de beneficiarios en el formato solicitado, con los encabezados fijos alias, cuenta y banco y filas de ejemplo para CLABE, tarjeta y celular/DiMo. Sirve de punto de partida para la importación masiva.+ - [Exportar los beneficiarios de la cuenta de usuario](https://docs.veriko.mx/es/v1/beneficiaries/export-beneficiaries): Descarga las cuentas beneficiarias del usuario autenticado como archivo, usa el mismo filtro with_archived que GET /v1/beneficiaries.+ - [Obtener el resumen del panel](https://docs.veriko.mx/es/v1/dashboard/get-dashboard-summary): Devuelve los contadores agregados del usuario: el total histórico, el total del mes UTC en curso, las validaciones con veredicto valid, el contador mensual de los estados queued y processing, el monto promedio y la tasa de éxito. Incluye también la cantidad de beneficiarios activos.+ - [Desglosar consumo por operación](https://docs.veriko.mx/es/v1/usage/get-usage-breakdown): Desglosa el consumo del periodo indicado por tipo de operación contabilizada (validation y sms_2fa).+ - [Consultar índices de consumo mes a mes](https://docs.veriko.mx/es/v1/usage/get-usage-history): Devuelve el consumo mensual de validaciones del usuario autenticado en hasta months meses con consumo, de más reciente a más antiguo. Los meses sin consumo no aparecen.+ - [Descargar el CEP oficial](https://docs.veriko.mx/es/v1/validations/download-cep): Descarga el Comprobante Electrónico de Pago (CEP) emitido por Banxico de una validación con veredicto valid, o returned cuando el CEP se descargó antes de conocerse la devolución.+ - [Exportar todas las entregas webhook como CSV o XLSX](https://docs.veriko.mx/es/v1/webhooks/export-all-deliveries): Descarga el historial de entregas de todos los endpoints de la cuenta de usuario en un archivo, con los mismos filtros y la misma búsqueda (q) que el listado.+ - [Inspect your account profile](https://docs.veriko.mx/en/how-to/inspect-my-account): Retrieve the complete profile for the authenticated account in a single call: user data, active subscription, and verification status.+ - [Start a bulk beneficiary import](https://docs.veriko.mx/en/v1/beneficiaries/create-beneficiary-import): Uploads a file — CSV, XLS, XLSX, TXT, JSON, or PDF, up to 20 MB — and opens an import job with it. XLSX/XLS sheets allow up to 10,000 rows and 64 columns. XLSX formulas are read as text without evaluation. PDFs allow up to 50 pages and cap decoded streams at 8 MiB. The reading mode decides how much work the file does and how much the server does:+ - [Download bulk import template](https://docs.veriko.mx/en/v1/beneficiaries/download-beneficiary-import-template): Returns a template file in the requested format, with the fixed headers alias, cuenta and banco and example rows for CLABE, card and DiMo phone. Serves as a starting point for the bulk import.+ - [Export beneficiaries as CSV](https://docs.veriko.mx/en/v1/beneficiaries/export-beneficiaries): Downloads the beneficiary accounts of the authenticated account as a file, under the same with_archived filter as GET /v1/beneficiaries.+ - [Get dashboard summary](https://docs.veriko.mx/en/v1/dashboard/get-dashboard-summary): Returns the user's aggregate counters: the lifetime total, the current UTC-month total, validations with verdict valid, the monthly count of the queued and processing states, the average amount, and the success rate. It also includes the active beneficiary count.+ - [Usage breakdown by operation](https://docs.veriko.mx/en/v1/usage/get-usage-breakdown): Breaks down the indicated period's usage by billable operation type (validation and sms_2fa).+ - [Monthly usage history](https://docs.veriko.mx/en/v1/usage/get-usage-history): Returns the authenticated user's monthly validation usage for up to months months with usage, most recent first. Months without usage are omitted.+ - [Download the official CEP](https://docs.veriko.mx/en/v1/validations/download-cep): Downloads the Electronic Payment Receipt (CEP) issued by Banxico for a validation with a valid verdict, or returned when the CEP was downloaded before the return was known.+ - [Export all deliveries as CSV or XLSX](https://docs.veriko.mx/en/v1/webhooks/export-all-deliveries): Downloads the delivery history of every endpoint on the account as a file, under the same filters and text search (q) as the list.+ - [List deliveries across all endpoints](https://docs.veriko.mx/en/v1/webhooks/list-all-deliveries): Consolidated view of the authenticated user's webhook deliveries, across all their endpoints at once.

version

0.1.9 → 0.1.10

https://docs.veriko.mx/llms.txt

− - [Límites de tasa](https://docs.veriko.mx/es/concepts/rate-limits): Ventana por minuto, respuesta 429 y cabeceras de recuperación.− - [Crear, actualizar y exportar beneficiarios](https://docs.veriko.mx/es/how-to/manage-beneficiaries): Gestiona tus cuentas beneficiarias guardadas — añade CLABEs, tarjetas y números DiMo a tu lista blanca, actualiza alias, archiva entradas obsoletas y exporta la lista completa para conciliación.− - [Rate limits](https://docs.veriko.mx/en/concepts/rate-limits): Per-minute window, the 429 response and its recovery headers.− - [Create, update, and export beneficiaries](https://docs.veriko.mx/en/how-to/manage-beneficiaries): Manage your saved beneficiary accounts — add CLABEs, cards, and DiMo numbers to your whitelist, update aliases, archive stale entries, and export the full list for reconciliation.+ - [Retención de comprobantes y datos](https://docs.veriko.mx/es/concepts/data-retention): Qué conserva la plataforma de una validación, cómo evitar que guarde el archivo con retain_image y qué borra y qué deja el borrado definitivo.+ - [Límites de tasa](https://docs.veriko.mx/es/concepts/rate-limits): Límites por plan en la API y en los webhooks, ventana por minuto, respuesta 429 y cabeceras.+ - [Crear, actualizar y exportar beneficiarios](https://docs.veriko.mx/es/how-to/manage-beneficiaries): Gestiona tus cuentas beneficiarias guardadas — añade CLABEs, tarjetas y números DiMo a tu lista blanca, actualiza etiquetas, archiva entradas obsoletas y exporta la lista completa para conciliación.+ - [Borrar una validación de forma definitiva](https://docs.veriko.mx/es/how-to/purge-a-validation): Borra el comprobante, el CEP y los datos de una validación propia en dos pasos, con un token de confirmación, y deja una lápida que conserva el veredicto, las fechas y el monto.+ - [Obtener el calendario de días inhábiles SPEI de un año](https://docs.veriko.mx/es/v1/public/get-spei-calendar): Devuelve el calendario de días inhábiles SPEI de un año, con la disposición oficial de la que sale.+ - [Ejecutar el borrado definitivo de una validación](https://docs.veriko.mx/es/v1/validations/execute-validation-purge): Borra de forma definitiva el contenido de una validación propia, con el token que emitió POST /v1/validations/{id}/purge/prepare. Es el segundo paso de un flujo de dos pasos: sin ese token no se borra nada.+ - [Preparar el borrado definitivo de una validación](https://docs.veriko.mx/es/v1/validations/prepare-validation-purge): Describe lo que borraría el borrado definitivo de una validación propia y emite el token con el que POST /v1/validations/{id}/purge/execute lo confirma. No cambia nada: la validación y sus archivos quedan como estaban.+ - [Volver a consultar el estado de pago de una validación](https://docs.veriko.mx/es/v1/validations/recheck-validation): Vuelve a consultar a Banxico el estado del pago de una validación valid y, si lo reporta devuelto, la pasa a returned.+ - [Retention of receipts and data](https://docs.veriko.mx/en/concepts/data-retention): What the platform keeps of a validation, how to stop it from keeping the file with retain_image, and what the permanent deletion removes and leaves behind.+ - [Rate limits](https://docs.veriko.mx/en/concepts/rate-limits): Limits per plan on the API and on webhooks, the per-minute window, the 429 response and its headers.+ - [Create, update, and export beneficiaries](https://docs.veriko.mx/en/how-to/manage-beneficiaries): Manage your saved beneficiary accounts — add CLABEs, cards, and DiMo numbers to your whitelist, update labels, archive stale entries, and export the full list for reconciliation.+ - [Permanently delete a validation](https://docs.veriko.mx/en/how-to/purge-a-validation): Delete the receipt, the CEP, and the data of one of your own validations in two steps, with a confirmation token, leaving a tombstone that keeps the verdict, the dates, and the amount.+ - [Get the calendar of SPEI non-business days for a year](https://docs.veriko.mx/en/v1/public/get-spei-calendar): Returns the calendar of SPEI non-business days for a year, with the official provision it comes from.+ - [Execute the permanent deletion of a validation](https://docs.veriko.mx/en/v1/validations/execute-validation-purge): Permanently deletes the content of one of your own validations, with the token issued by POST /v1/validations/{id}/purge/prepare. It is the second step of a two-step flow: without that token nothing is deleted.+ - [Prepare the permanent deletion of a validation](https://docs.veriko.mx/en/v1/validations/prepare-validation-purge): Describes what the permanent deletion of one of your own validations would delete and issues the token with which POST /v1/validations/{id}/purge/execute confirms it. It changes nothing: the validation and its files stay as they were.+ - [Query the payment status of a validation again](https://docs.veriko.mx/en/v1/validations/recheck-validation): Queries Banxico again for the payment status of a valid validation and, if it reports the payment as returned, moves it to returned.

https://raw.githubusercontent.com/veriko-mx-labs/veriko-mcp/HEAD/AGENTS.md

−    `src/catalog.ts`. `known_gaps` no es una solución permanente.+    `src/catalog.ts`. `known_gaps` no es una solución permanente. La única+    excepción es `NOT_EXPOSED_OPERATIONS`: el borrado definitivo de una+    validación no se anuncia, porque no se puede deshacer.

version

0.1.8 → 0.1.9

version

0.1.7 → 0.1.8