Back to Directory/Developer Tools

io.github.elmatis172/validalatam-mcp

Validate LatAm tax, ID and bank numbers: CUIT, CPF, CNPJ, RFC, CURP, RUT, NIT, RUC, CLABE

Developer ToolsPythonv0.2.0

validalatam-mcp

MCP server for the ValidaLatam API — validate, normalize and format Latin American tax IDs, national IDs and bank accounts: AR CUIT/CUIL/DNI/CBU/CVU, BR CPF/CNPJ, MX RFC/CURP/CLABE, CL RUT, CO NIT, PE RUC, UY CI/RUT, EC Cédula/RUC, PY RUC, IBAN.

This is a thin client: every tool call is an HTTP request to the hosted API. No validation algorithms are included here.

API key / plans on RapidAPI: https://rapidapi.com/MatiasPengue/api/validalatam

English | Español

English

Install

uvx --from git+https://github.com/elmatis172/validalatam-mcp validalatam-mcp
# or
pip install git+https://github.com/elmatis172/validalatam-mcp
validalatam-mcp

(Once published to PyPI: uvx validalatam-mcp / pip install validalatam-mcp.)

Claude Desktop (claude_desktop_config.json) / Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "validalatam": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/elmatis172/validalatam-mcp", "validalatam-mcp"],
      "env": { "RAPIDAPI_KEY": "optional-your-key" }
    }
  }
}

Tools

  • validate_document(type, value, country?) — type="AUTO" auto-detects
  • validate_batch(items) — up to 1000 {type, value, country?}
  • generate_test_data(type, count, seed) — clearly fake, check-digit-valid values
  • list_document_types()

Configuration

Env varDefaultPurpose
RAPIDAPI_KEY–If set, calls go through RapidAPI (validalatam.p.rapidapi.com)
VALIDALATAM_BASE_URLhttps://validalatam.ia-latam.appOverride API base URL

Docker

docker build -t validalatam-mcp . && docker run -i --rm validalatam-mcp

Client SDKs

Zero-dependency clients in sdks/python/validalatam_client.py and sdks/js/index.mjs.

Development

pip install -e ".[test]" && pytest

Español

Servidor MCP para la API ValidaLatam: valida, normaliza y formatea CUIT/CUIL, DNI, CBU/CVU, CPF, CNPJ, RFC, CURP, CLABE, RUT, NIT, RUC, CI, cédulas e IBAN. Es un cliente liviano: cada herramienta llama por HTTP a la API alojada; no incluye los algoritmos de validación.

Clave de API y planes en RapidAPI: https://rapidapi.com/MatiasPengue/api/validalatam

Instalación

uvx --from git+https://github.com/elmatis172/validalatam-mcp validalatam-mcp
# o
pip install git+https://github.com/elmatis172/validalatam-mcp

Claude Desktop / Cursor

Usá el mismo bloque JSON de arriba en claude_desktop_config.json o ~/.cursor/mcp.json. RAPIDAPI_KEY es opcional.

Herramientas

validate_document, validate_batch, generate_test_data (datos FALSOS de prueba), list_document_types.

License / Licencia

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx validalatam-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-elmatis172-validalatam-mcp": {
      "command": "uvx",
      "args": [
        "validalatam-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

validalatam-mcppypi

Compatible MCP Clients

io.github.elmatis172/validalatam-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More