# Veriko

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: veriko-mx-labs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/veriko-mx-labs/veriko-mcp
- Updated: 2026-10-24
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/veriko

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.veriko.mx/mcp`
- Environment variables: `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` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
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/mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http veriko https://api.veriko.mx/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add veriko --url https://api.veriko.mx/mcp
```

2. **Platform CLI**
```bash
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/mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "veriko": {
            "url": "https://api.veriko.mx/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "veriko": {
            "type": "http",
            "url": "https://api.veriko.mx/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http veriko https://api.veriko.mx/mcp
```

2. **Platform CLI**
```bash
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/mcp
```
Replace <…> with your own values. 3 more environment variables are in the server README

## When to use it
- 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
- Check this SPEI transfer against Banxico’s CEP.
- Show me the result from the previous payment check.
- Download the CEP receipt for this transfer.

## Similar
- [mcp-stp-spei](https://affpapa.org/en/nevibecode/mcp/mcp-stp-spei.md) — MCP server · ★ 279 repo stars
- [mcp-kushki](https://affpapa.org/en/nevibecode/mcp/mcp-kushki.md) — MCP server · ★ 279 repo stars
- [onchain-pay-open-api](https://affpapa.org/en/nevibecode/skills/onchain-pay-open-api.md) — skill · 6100 installs
- [fiat](https://affpapa.org/en/nevibecode/skills/fiat.md) — skill · 5900 installs
- [payment-provider-protocol](https://affpapa.org/en/nevibecode/skills/payment-provider-protocol.md) — skill · 1100 installs
- [stripe](https://affpapa.org/en/nevibecode/skills/membrane-stripe.md) — skill · 277 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
