English Français العربية

io.github.elmatis172/validalatam-mcp

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.elmatis172/validalatam-mcp؟

  • 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()

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package validalatam-mcp
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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "validalatam-mcp": {
            "command": "uvx",
            "args": [
                "validalatam-mcp==0.2.2"
            ],
            "env": {
                "RAPIDAPI_KEY": "<your rapidapi_key>",
                "VALIDALATAM_BASE_URL": "<VALIDALATAM_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • RAPIDAPI_KEY سري Optional RapidAPI key; routes calls through RapidAPI
  • VALIDALATAM_BASE_URL Override API base URL

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. validalatam-mcp
  2. English
  3. Español
  4. License / Licencia

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–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_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 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

الأسئلة الشائعة

ما هو io.github.elmatis172/validalatam-mcp؟

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

كيف أثبّت io.github.elmatis172/validalatam-mcp؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.elmatis172/validalatam-mcp إلى مفتاح API؟

نعم. يتطلب RAPIDAPI_KEY، وتضبطها في إعداداته.

هل io.github.elmatis172/validalatam-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.elmatis172/validalatam-mcp؟

ينشره elmatis172. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.