io.github.veriko-mx-labs/veriko
OfficialThis server exposes only two read-only public-plan tools for Veriko, not the full MCP catalog.
List public Veriko plans without an API key.
Compare public plan capabilities and prices without an API key.
Both tools are read-only, idempotent, take no inputs, and have no validation-quota cost.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.veriko-mx-labs/veriko valida esta transferencia SPEI"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Veriko MCP
El servidor MCP de Veriko conecta Veriko con Cursor u otro cliente compatible con MCP. Le pides al asistente que compruebe un pago en el CEP de Banxico, que te diga en qué quedó una validación anterior o que descargue el comprobante.
El servidor cubre como herramientas 73 de las 75 operaciones públicas de máquina
a máquina. Deja fuera las dos operaciones de purga (prepare y execute),
porque un borrado definitivo no se puede deshacer. Otras tres herramientas
esperan un resultado asíncrono: veriko_wait_for_validation,
veriko_wait_for_cep_export y veriko_wait_for_beneficiary_import. Con eso son
76 herramientas en el perfil all.
Instalación
Hay dos formas de conectar el servidor. Con la local, tu cliente arranca el
paquete en tu computadora. Con la remota, se conecta al servidor que Veriko
mantiene en https://api.veriko.mx/mcp, sin instalar nada.
Local, con npx
Requiere Node.js 20 o posterior. Sin clonar nada, el cliente arranca el
servidor con npx:
npx -y @veriko-mx/mcpEn Cursor y en otros editores compatibles con MCP que leen mcpServers en su
archivo de configuración de MCP:
{
"mcpServers": {
"veriko": {
"command": "npx",
"args": ["-y", "@veriko-mx/mcp"],
"env": { "VERIKO_API_KEY": "veriko_..." }
}
}
}En VS Code (.vscode/mcp.json), que pide la clave al arrancar en lugar de
guardarla en el archivo:
{
"inputs": [
{
"type": "promptString",
"id": "veriko-api-key",
"description": "Clave de API de Veriko",
"password": true
}
],
"servers": {
"veriko": {
"command": "npx",
"args": ["-y", "@veriko-mx/mcp"],
"env": { "VERIKO_API_KEY": "${input:veriko-api-key}" }
}
}
}Remota
El servidor remoto usa Streamable HTTP en https://api.veriko.mx/mcp. En Claude,
ChatGPT y otros clientes que conectan con OAuth basta con la URL: el cliente te
lleva a Veriko para iniciar sesión y elegir los permisos. En los demás, cada
petición lleva tu clave de API en el encabezado Authorization: Bearer. Es el
mismo servidor del paquete, con las mismas herramientas, pero no lee archivos de
tu computadora: para image_path y file_path usa la instalación local.
En Cursor, con la clave en una variable de entorno:
{
"mcpServers": {
"veriko": {
"url": "https://api.veriko.mx/mcp",
"headers": { "Authorization": "Bearer ${env:VERIKO_API_KEY}" }
}
}
}En VS Code:
{
"inputs": [
{
"type": "promptString",
"id": "veriko-api-key",
"description": "Clave de API de Veriko",
"password": true
}
],
"servers": {
"veriko": {
"type": "http",
"url": "https://api.veriko.mx/mcp",
"headers": { "Authorization": "Bearer ${input:veriko-api-key}" }
}
}
}Otros editores compatibles con MCP aceptan una URL remota y encabezados
personalizados: usa la misma URL y el mismo encabezado Authorization. La
clave nunca se escribe en un archivo que subas al repositorio.
Related MCP server: Consultas
Probarlo desde el código fuente
git clone https://github.com/veriko-mx-labs/veriko-mcp.git
cd veriko-mcp
npm ci
npm run buildQueda un servidor ejecutable en dist/index.js. Para verlo responder sin clave
de API, el perfil de planes públicos no necesita credenciales:
VERIKO_MCP_PROFILE=plans VERIKO_MCP_MAX_RISK=read node dist/index.jsEl proceso se queda esperando mensajes MCP por stdin; lo normal es que lo arranque tu cliente. Esta es la configuración del host, con la ruta absoluta a la copia que acabas de construir:
{
"mcpServers": {
"veriko": {
"command": "node",
"args": ["/ruta/a/veriko-mcp/dist/index.js"],
"env": {
"VERIKO_API_KEY": "veriko_...",
"VERIKO_MCP_PROFILE": "core",
"VERIKO_MCP_MAX_RISK": "write"
}
}
}
}La clave se obtiene en app.veriko.mx. Nunca es un argumento de una
herramienta: el servidor sólo la lee de VERIKO_API_KEY, de modo que un texto
inyectado en una página que el modelo esté leyendo no puede pedírsela. Las
herramientas que leen datos públicos (perfil plans, estado de Banxico,
catálogo de bancos) funcionan sin clave.
Variables de entorno
Variable | Descripción | Predeterminado |
| Clave de API del integrador ( | ninguno |
|
|
|
| Riesgo máximo que se anuncia: |
|
| URL base de la API (HTTPS; HTTP sólo para | API de producción |
| Tiempo límite por petición, de 1,000 a 300,000 | 60,000 |
| Reintentos automáticos de fallas transitorias, de 0 a 5 | 2 |
| Idioma del texto de los errores de la API: |
|
| Directorios absolutos, separados por el delimitador de rutas de la plataforma, de los que pueden leer | ninguno |
Lo que consume cuota
veriko_validate_direct y veriko_validate_ocr consumen cuota del plan, que se
descuenta cuando la API acepta la petición. Cada descripción lo dice, porque un
ciclo de un agente puede vaciar una cuota mensual en minutos. El resultado
informa el saldo restante, y el texto avisa cuando queda poco. El resto del
catálogo consulta, exporta o descarga sin consumir validaciones.
Consulta antes el saldo con veriko_get_usage_limits, que pertenece al perfil
core.
Perfiles
VERIKO_MCP_PROFILE acepta core, all, una familia o varias familias
separadas por coma.
Perfil | Herramientas anunciadas |
| validar, validar una cuenta, listar, consultar, esperar y descargar un CEP, límites de uso |
| ciclo completo de validaciones |
| endpoints, entregas y secretos |
| bancos, calendario SPEI, BIN y estado de Banxico |
| lista e importación masiva |
| consumo, límites y exportación |
| perfil y política de reintentos |
| resumen operativo |
| planes públicos |
| métricas agregadas |
| resúmenes, vistas previas, descargas y exportaciones de CEP |
| suscripción activa |
| las 76 herramientas |
El perfil decide qué familias ve el modelo. El riesgo se controla de forma
independiente con VERIKO_MCP_MAX_RISK:
read: sólo consultas y descargas;write(predeterminado): agrega validaciones y cambios normales;destructive: agrega eliminaciones, cancelaciones, rotación de secretos y la confirmación de importaciones.
Lo que cuesta anunciar cada perfil
Anunciar una herramienta gasta contexto antes de que el modelo llame a ninguna.
Estas cifras salen del propio servidor: bytes de la respuesta tools/list, con
npm run measure:catalog. Los tokens son una estimación a 3.6 bytes por token,
no una tokenización real, y sirven para comparar perfiles entre sí. Las cifras
incluyen el esquema de salida de cada herramienta.
Perfil | Herramientas | Bytes de | Tokens estimados |
| 8 | 26,952 | ~7,487 |
| 15 | 45,822 | ~12,728 |
| 10 | 29,850 | ~8,292 |
| 5 | 6,898 | ~1,916 |
| 16 | 27,784 | ~7,718 |
| 7 | 9,055 | ~2,515 |
| 3 | 4,957 | ~1,377 |
| 1 | 1,253 | ~348 |
| 2 | 2,207 | ~613 |
| 4 | 5,094 | ~1,415 |
| 12 | 21,221 | ~5,895 |
| 1 | 1,087 | ~302 |
| 76 | 155,218 | ~43,116 |
Medido con Node 22 y riesgo destructive, para no ocultar herramientas. all
cuesta 5.7 veces lo que core; por eso el perfil predeterminado es core y se
amplía por familia cuando hace falta. test/tools-list-size.test.ts falla cuando
un perfil rebasa su presupuesto.
Comportamiento de las herramientas
Nombres y entradas. Las herramientas se llaman
veriko_<operationId en snake_case>. El prefijo mantiene únicos los nombres en un host que conecta varios servidores, y los nombres no cambian entre versiones. Los campos de entrada usan los nombres de la API ensnake_case, cada uno con su descripción, y los enums, mínimos y máximos del contrato público.Salida estructurada. Cada herramienta declara un
outputSchemay devuelvestructuredContentmás el mismo JSON como texto. Un objeto_calllleva el id de la petición, la marcaIdempotent-Replayed, la cuota, la ventana de límite de frecuencia,retry_after_secondsy, cuando la API lo anuncia,deprecationysunset. El texto se recorta a 64 KiB;structuredContentnunca se recorta.Idempotencia. Cada escritura envía un
Idempotency-Keyaleatorio por llamada. Para reintentar sin riesgo tras una respuesta perdida, repite la llamada con la mismaidempotency_key;idempotent_replayed: truesignifica que la API devolvió la respuesta guardada.Resultados asíncronos. Una validación puede responder
queuedoprocessing.veriko_wait_for_validation,veriko_wait_for_cep_exportyveriko_wait_for_beneficiary_importconsultan hasta que el recurso llega a un estado terminal o termina la espera (25 segundos por omisión, hasta 40). Respetannext_poll_after_secondsyRetry-After, y respondenterminal: falsecon el intervalo cuando se acaba el tiempo. Las lecturas condicionales que devuelven304llegan como{ "not_modified": true, "etag": ... }, no como errores.Errores. Una llamada fallida devuelve
isErrorconcode,status,retryable,retry_after_seconds,request_idy la lista completaerrors(code,title,detail,hint,docs_url,pointer,meta). Un429por cuota agotada (kind: quota) y uno por límite de frecuencia (kind: rate_limit) regresan de inmediato, conretry_after_seconds; el servidor no espera dormido a que pasen.Confirmación. Cuando el cliente declara la capacidad
elicitation, el servidor pregunta antes deveriko_delete_validation,veriko_delete_webhook,veriko_regenerate_webhook_secret,veriko_delete_beneficiary,veriko_delete_beneficiary_import_row,veriko_commit_beneficiary_import,veriko_update_validation_retry_policyyveriko_update_my_retry_policy. Una pregunta rechazada o cerrada devuelveexecuted: falsecon elreason, y no se envía nada a la API. Un cliente sin la capacidad ejecuta la operación, yVERIKO_MCP_MAX_RISKsigue siendo la compuerta.Avance y cancelación. Cuando la petición trae un
progressToken, las herramientas de espera envían unanotifications/progresspor consulta, y las descargas envían una al empezar la petición y otra cuando llega el archivo. Cancelar la petición aborta la llamada en curso, sus reintentos y la pausa entre consultas; el resultado escancelled.Descargas. Los archivos regresan como recursos incrustados hasta 256 KiB, y como enlaces
veriko://artifact/...por encima de eso (stdio), con el tipo MIME correcto. El servidor infiere el tipo de una descargaapplication/octet-streampor la extensión y los primeros bytes.Límites. El servidor valida base64 canónico y los límites públicos antes de llamar al SDK: 12 MB para comprobantes OCR (imagen o PDF) y 20 MB para importaciones de beneficiarios. El transporte stdio admite completa una importación máxima.
Archivos locales. Por stdio, define
VERIKO_MCP_FILE_ROOTSyveriko_validate_ocraceptaimage_path, yveriko_create_beneficiary_importaceptafile_path, en lugar de base64. La ruta debe ser absoluta y, una vez resueltos los enlaces, estar dentro de una de las raíces. El servidor revisa los límites de tamaño anteriores, los primeros bytes de un comprobante (JPEG, PNG, WebP o PDF) y la extensión de un archivo de importación antes de enviar nada. Sin la variable, los argumentos no se anuncian, y el servidor HTTP nunca los anuncia ni los lee.Autocompletado. Los argumentos de los prompts y las variables de las plantillas de recursos responden
completion/complete: los estados de validación, los eventos de webhook y los formatos de exportación salen de los enums del spec, los códigos de banco del catálogo público de bancos (por código, nombre o alias), y el año del calendario SPEI del año en curso.User agent. Las peticiones envían
veriko-mcp/<versión> (<transporte>) veriko-sdk-js/<versión> (...).
Recursos
URI | Contenido |
| Catálogo de bancos SPEI |
| Un banco SPEI por su código de 5 dígitos |
| Días inhábiles SPEI de un año |
| Planes públicos |
| Estado del servicio de Banxico |
| Enlaces a la documentación en |
| Archivos descargados en la sesión actual (stdio) |
Prompts
check_transfer, reconcile_month, triage_failed_validations,
set_up_webhook, export_validations e import_beneficiaries inician un flujo
guiado con las herramientas reales del catálogo.
Arquitectura
Usa el SDK oficial de JavaScript como única capa de transporte hacia la API. El código lo importa mediante
@veriko-mx/sdk-runtime, un alias estable que permite cambiar la fuente de distribución sin reescribir el servidor.El SDK runtime viaja incluido en el tarball del MCP.
Anuncia herramientas según perfil y riesgo.
Los errores usan
error.code, estado, puntero, id de la petición e intervalo de reintento cuando existen; el texto traducible de la API no es un contrato.
Desarrollo
npm ci
npm run build
npm run typecheck
npm test
npm run check:surface
npm run measure:catalog
npm run evalscheck:surface compara el catálogo completo contra el spec público del SDK y
fija su SHA-256. Las operaciones que el catálogo no anuncia, las dos operaciones
de purga, se declaran aparte en NOT_EXPOSED_OPERATIONS. Una operación nueva,
retirada o escondida, un esquema de autenticación distinto de la clave de API o
cualquier cambio contractual falla esta comprobación. El workflow de
sincronización deja el PR del contrato nuevo como borrador, con el CI corrido y
un resumen del cambio en el cuerpo, para revisarlo antes de aceptarlo.
Las pruebas no usan la API real. test/server.test.ts conecta un cliente y un
servidor MCP en memoria con un SDK falso; test/http.test.ts levanta el modo
HTTP en un puerto local. npm run evals ejecuta los escenarios de evals/
contra una API falsa.
Transportes
El núcleo vive en createVerikoServer() y no depende del transporte. Hay dos:
stdio (
veriko-mcp): el cliente lo arranca como proceso local y la clave se lee deVERIKO_API_KEY. Las descargas son recursosveriko://artifact/...o recursos incrustados.Streamable HTTP sin estado (
veriko-mcp-http): un endpoint que se puede poner detrás de un proxy. No hay sesiones ni memoria entre peticiones.
Modo HTTP
npm run build
VERIKO_MCP_HTTP_PORT=3000 node dist/http-index.jsEscucha en 127.0.0.1:3000/mcp; GET /healthz responde sin autenticación.
Autenticación. Cada petición lleva la clave de API del integrador o un token de acceso OAuth (un JWT con
typ: at+jwt) comoAuthorization: Bearer <token>. Sin él, o si no tiene ninguna de las dos formas, la respuesta es 401; conVERIKO_MCP_RESOURCE_METADATA_URL, el 401 anuncia los metadatos del recurso enWWW-Authenticate. Un token OAuth se verifica antes de leer el cuerpo: firma con la clave de sukiden el JWKS del servidor de autorización,iss,expyaudigual alresourcede esos metadatos. Todo sale por descubrimiento desde esa URL; sin ella no se aceptan tokens OAuth. Un token que no pasa recibe 401 conerror="invalid_token", y si no se pudo leer el JWKS la respuesta es 503. La credencial sólo viaja aVERIKO_BASE_URL: una petición a otra URL sale sinAuthorization. El servidor crea un cliente nuevo por petición, no guarda ni registra la clave e ignoraVERIKO_API_KEYdel entorno, para que nunca se use una clave del servidor en nombre de otra persona.Descargas. Como la siguiente petición puede caer en otro proceso, el archivo no se guarda: viaja incrustado en la respuesta como recurso con
bloben base64, con un tope de 8 MB. Más allá devuelve el errorartifact_too_largecon el tamaño, el límite y unhint: bajalimit, acotafromyto, agrega un filtro, o usa stdio o la API.Host y Origin. El encabezado
Hostdebe estar enVERIKO_MCP_ALLOWED_HOSTS; sin configurarla sólo se admitenlocalhost,127.0.0.1y[::1], y el servidor no arranca si escucha en otra dirección. Una petición conOrigin(las de un navegador) sólo pasa si ese origen está enVERIKO_MCP_ALLOWED_ORIGINS; los clientes que no son navegador no lo envían.Tamaño del cuerpo. Un cuerpo declarado mayor que el tope se rechaza con 413 sin leerlo.
Perfiles y riesgo.
VERIKO_MCP_PROFILEyVERIKO_MCP_MAX_RISKvalen para todo el servidor, igual que en stdio. Una petición puede acotarlos conX-Veriko-ProfileyX-Veriko-Max-Risk; un valor más amplio responde 403 y uno desconocido 400. Las comprobaciones corren después de las deHost,Originy clave.Idioma.
Accept-Language(enoes) fija el idioma del texto de los errores de la API para esa petición.
Variable | Descripción | Predeterminado |
| Puerto |
|
| Dirección de escucha |
|
| Ruta del endpoint |
|
| Nombres de host admitidos en |
|
| Orígenes de navegador permitidos ( | vacío |
| Tamaño máximo del cuerpo | 32 MiB |
| Tope de un archivo incrustado | 8 MiB |
El servidor no termina TLS: se despliega detrás de un proxy HTTPS.
Seguridad
Consulta SECURITY.md. Nunca abras issues con claves de API, payloads reales, comprobantes, números de cuenta o respuestas sin sanitizar.
Licencia
MIT.
Available Tools
2 toolsveriko_get_public_plan_comparisonComparar los planes públicosARead-onlyIdempotentInspect
Compara las capacidades y los precios de los planes públicos. No necesita clave de API.
Inputs: no named parameters. Returns: _call
veriko_list_public_plansListar los planes públicosARead-onlyIdempotentInspect
Lista los planes públicos. No necesita clave de API.
Inputs: no named parameters. Returns: _call
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools target distinct actions: listing plans versus comparing capabilities and prices. There is some overlap because a comparison tool may implicitly include the list of plans, but the descriptions make the boundary reasonably clear.
Both tools use the same veriko_ prefix and a consistent snake_case verb_noun pattern: list_public_plans and get_public_plan_comparison. The convention is predictable and easy to scan.
Two tools is quite thin for a server surface, even one focused on public plans. It is not an extreme mismatch, but the server feels more like a narrow endpoint pair than a well-rounded toolset.
The surface covers listing and comparing public plans, which are the core public read operations. However, there is no tool to retrieve details for a single plan or filter/search plans, leaving a notable gap for common plan-inspection workflows.
Maintenance
Related MCP Connectors
Deterministic Mexican/LatAm verification + sanctions & PEP screening for AI agents. Pay via x402.
Mexican RFC/SAT 69-B, CFDI, CURP (RENAPO) and INE checks against the official registries.
Validate IBANs and bank codes, verify payee names, and screen names against sanctions lists.
LatAm Validate MCP — validate Latin-American banking and tax identifiers.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables querying Mexico's SAT public lists to verify RFCs in bulk, search by business name, and obtain tax risk verdicts such as critical, high, medium, low, or clean.6MIT
- AlicenseNot gradedqualityDmaintenanceEnables official-source lookups on people and companies, covering registration status, tax and labor clearance certificates, sanctions lists, trademarks/patents, and electronic invoices, with platform-hosted pay-per-query access.MIT
- AlicenseNot gradedqualityBmaintenanceEnables autonomous financial agents to submit payment webhooks, ledger entries, or transaction streams and receive balanced journal records, risk verification dossiers, and detection of card-testing clusters, volume spikes, and account takeovers.7MIT
- AlicenseAqualityCmaintenanceEnables MCP clients such as Claude, Cursor, and VS Code to validate, cross-check, and verify Mexican CURPs against RENAPO, check verification status, and query token balance.552 npmMIT