Veriko — Claude Code MCP server: features and setup
This MCP server for Claude Code checks SPEI transfers against Banxico’s CEP and accesses Veriko’s public API. Ask it to validate a payment, retrieve an earlier result, or download a receipt.
MIT updated 2026-10-24
claude mcp add --env VERIKO_API_KEY=<VERIKO_API_KEY> --env VERIKO_MCP_PROFILE=<VERIKO_MCP_PROFILE> --env VERIKO_MCP_MAX_RISK=<VERIKO_MCP_MAX_RISK> --env VERIKO_BASE_URL=<VERIKO_BASE_URL> --env VERIKO_TIMEOUT_MS=<VERIKO_TIMEOUT_MS> --transport stdio veriko -- npx -y @veriko-mx/mcpWhat Veriko does
Veriko connects an AI agent to the service API and checks SPEI transfers against Banxico’s CEP. Its tools cover validation, catalogue lookups, and receipt downloads. Profiles control which tool groups the model can access, while VERIKO_MCP_MAX_RISK sets the highest operation risk the server exposes.
Local use requires Node.js 20 or later and a VERIKO_API_KEY; the client starts the package with npx -y @veriko-mx/mcp. A remote option is available at https://api.veriko.mx/mcp. It cannot access files on the computer, so image_path and file_path need a local installation. The veriko_validate_direct and veriko_validate_ocr tools use plan quota.
What it helps with
- check a SPEI transfer against Banxico’s CEP
- retrieve the result of an earlier payment validation
- download a CEP receipt
- look up API usage limits
Example prompts for the agent
- Check this SPEI transfer against Banxico’s CEP.
- Show me the result from the previous payment check.
- Download the CEP receipt for this transfer.
How to install Veriko
1Platform CLI
claude mcp add --env VERIKO_API_KEY=<VERIKO_API_KEY> --env VERIKO_MCP_PROFILE=<VERIKO_MCP_PROFILE> --env VERIKO_MCP_MAX_RISK=<VERIKO_MCP_MAX_RISK> --env VERIKO_BASE_URL=<VERIKO_BASE_URL> --env VERIKO_TIMEOUT_MS=<VERIKO_TIMEOUT_MS> --transport stdio veriko -- npx -y @veriko-mx/mcpReplace <…> with your own values. 3 more environment variables are in the server README
2Platform CLI: remote server
claude mcp add --transport http veriko https://api.veriko.mx/mcp1Platform CLI: remote server
codex mcp add veriko --url https://api.veriko.mx/mcp2Platform CLI
codex mcp add veriko --env VERIKO_API_KEY=<VERIKO_API_KEY> --env VERIKO_MCP_PROFILE=<VERIKO_MCP_PROFILE> --env VERIKO_MCP_MAX_RISK=<VERIKO_MCP_MAX_RISK> --env VERIKO_BASE_URL=<VERIKO_BASE_URL> --env VERIKO_TIMEOUT_MS=<VERIKO_TIMEOUT_MS> -- npx -y @veriko-mx/mcpReplace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"mcpServers": {
"veriko": {
"url": "https://api.veriko.mx/mcp"
}
}
}{
"mcpServers": {
"veriko": {
"command": "npx",
"args": [
"-y",
"@veriko-mx/mcp"
],
"env": {
"VERIKO_API_KEY": "<VERIKO_API_KEY>",
"VERIKO_MCP_PROFILE": "<VERIKO_MCP_PROFILE>",
"VERIKO_MCP_MAX_RISK": "<VERIKO_MCP_MAX_RISK>",
"VERIKO_BASE_URL": "<VERIKO_BASE_URL>",
"VERIKO_TIMEOUT_MS": "<VERIKO_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
Config file
{
"servers": {
"veriko": {
"type": "http",
"url": "https://api.veriko.mx/mcp"
}
}
}{
"servers": {
"veriko": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@veriko-mx/mcp"
],
"env": {
"VERIKO_API_KEY": "<VERIKO_API_KEY>",
"VERIKO_MCP_PROFILE": "<VERIKO_MCP_PROFILE>",
"VERIKO_MCP_MAX_RISK": "<VERIKO_MCP_MAX_RISK>",
"VERIKO_BASE_URL": "<VERIKO_BASE_URL>",
"VERIKO_TIMEOUT_MS": "<VERIKO_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values. 3 more environment variables are in the server README
1Platform CLI: remote server
gemini mcp add -t http veriko https://api.veriko.mx/mcp2Platform CLI
gemini mcp add -e VERIKO_API_KEY=<VERIKO_API_KEY> -e VERIKO_MCP_PROFILE=<VERIKO_MCP_PROFILE> -e VERIKO_MCP_MAX_RISK=<VERIKO_MCP_MAX_RISK> -e VERIKO_BASE_URL=<VERIKO_BASE_URL> -e VERIKO_TIMEOUT_MS=<VERIKO_TIMEOUT_MS> veriko npx -y @veriko-mx/mcpReplace <…> with your own values. 3 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Veriko
How do I install Veriko in Claude Code?
For a local connection, run claude mcp add veriko -e VERIKO_API_KEY=<VERIKO_API_KEY> -- npx -y @veriko-mx/mcp. This setup requires Node.js 20 or later and a Veriko API key.
What does Veriko do?
It connects an agent to Veriko’s API to check SPEI transfers against Banxico’s CEP, retrieve earlier validation results, and download receipts.
What does Veriko need to run?
A local setup needs Node.js 20 or later and VERIKO_API_KEY. Public data in the plans profile can be accessed without a key.