io.github.elmatis172/validalatam-mcp
Validate LatAm tax, ID and bank numbers: CUIT, CPF, CNPJ, RFC, CURP, RUT, NIT, RUC, CLABE
Que pouvez-vous faire avec io.github.elmatis172/validalatam-mcp ?
validate_document(type, value, country?)—type="AUTO"auto-detectsvalidate_batch(items)— up to 1000{type, value, country?}generate_test_data(type, count, seed)— clearly fake, check-digit-valid valueslist_document_types()
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
validalatam-mcpclaude mcp add validalatam-mcp -e 'RAPIDAPI_KEY=<your rapidapi_key>' -e 'VALIDALATAM_BASE_URL=<VALIDALATAM_BASE_URL>' -- uvx validalatam-mcp==0.2.2
{
"mcpServers": {
"validalatam-mcp": {
"command": "uvx",
"args": [
"validalatam-mcp==0.2.2"
],
"env": {
"RAPIDAPI_KEY": "<your rapidapi_key>",
"VALIDALATAM_BASE_URL": "<VALIDALATAM_BASE_URL>"
}
}
}
}
Variables d'environnement
RAPIDAPI_KEYsecret Optional RapidAPI key; routes calls through RapidAPIVALIDALATAM_BASE_URLOverride API base URL
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
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-detectsvalidate_batch(items)— up to 1000{type, value, country?}generate_test_data(type, count, seed)— clearly fake, check-digit-valid valueslist_document_types()
Configuration
| Env var | Default | Purpose |
|---|---|---|
RAPIDAPI_KEY | – | Recommended. If set, calls go through RapidAPI (validalatam.p.rapidapi.com) and use your plan's quota (free Basic plan available). Without it, the public endpoint allows a small free number of validations per day per IP (a batch counts each document). |
VALIDALATAM_BASE_URL | https://validalatam.ia-latam.app | Override 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 pero recomendado: sin clave, el endpoint público permite unas pocas validaciones gratis por día y por IP (un batch cuenta cada documento). Con clave se usa la cuota de tu plan en RapidAPI (hay un plan Basic gratis).
Herramientas
validate_document, validate_batch, generate_test_data (datos FALSOS de prueba), list_document_types.
License / Licencia
MIT
Questions fréquentes
Qu'est-ce que io.github.elmatis172/validalatam-mcp ?
Validate LatAm tax, ID and bank numbers: CUIT, CPF, CNPJ, RFC, CURP, RUT, NIT, RUC, CLABE
Comment installer io.github.elmatis172/validalatam-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add validalatam-mcp -e 'RAPIDAPI_KEY=<your rapidapi_key>' -e 'VALIDALATAM_BASE_URL=<VALIDALATAM_BASE_URL>' -- uvx validalatam-mcp==0.2.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.elmatis172/validalatam-mcp ?
Oui. Il attend RAPIDAPI_KEY, à renseigner dans sa configuration.
io.github.elmatis172/validalatam-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.elmatis172/validalatam-mcp ?
Il est publié par elmatis172. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.