Conectá cualquier IA a Avalio
Avalio expone un servidor MCP (Model Context Protocol): el estándar abierto con el que Claude, ChatGPT, Cursor y cualquier agente de IA se conectan a herramientas externas. Con unos segundos de configuración, tu asistente puede consultar el riesgo de un CUIT o de un cheque en Argentina —con datos oficiales del BCRA, ARCA y Boletín Oficial— sin que escribas una sola línea de código.
El servidor usa la misma API key, el mismo cobro y el mismo sandbox que la API REST: las herramientas reenvían a los endpoints /api/v1 reales, así que lo que probás acá es exactamente lo que corre en producción.
https://avalio.com.ar/api/mcp · Transporte: JSON-RPC 2.0 sobre HTTP (streamable HTTP) · Autenticación: Authorization: Bearer avk_live_… | avk_test_…¿Querés probarlo sin pagar ni dar de alta nada? Conectalo con una clave de prueba avk_test_… y pedile el riesgo de cualquiera de los CUIT de sandbox: responde gratis, con la misma forma de respuesta que producción.
Qué puede hacer la IA (herramientas)
Al conectar el servidor, el asistente suma estas tres herramientas. Puede elegirlas solo según lo que le pidas en lenguaje natural:
riesgo_clienteRiesgo de un cliente o proveedor por CUIT (a quién le vendés a crédito), sin un cheque de por medio. Devuelve identidad, decisión explicable (aprobar/revisar/rechazar), score, índice de cobro, motivos con códigos estables y fuentes con fecha.
Con clave avk_live_ cobra 1 crédito por CUIT (idempotente). Con clave avk_test_ responde gratis los CUIT de sandbox.
analizar_chequeRiesgo de un cheque por el CUIT del librador, el monto y el plazo (o fecha de pago). Persiste el análisis y devuelve un id recuperable.
Consume 1 crédito. Requiere una clave avk_live_ con plan Business vigente.
consultar_cuitIdentidad de un CUIT: tipo de persona y DNI derivados del número, y nombre/estado/actividad/domicilio del padrón de ARCA si responde. Solo identidad, sin score.
No consume créditos.
Antes de empezar: tu API key
Generá una clave desde la app, en la sección API (solo el administrador). Para probar sin pagar usá una clave de prueba avk_test_… (responde los CUIT de sandbox, gratis). Para datos reales usá una de producción avk_live_…. La misma clave sirve para el MCP y para la API REST.
Conectar en Cursor (y clientes con URL)
Cursor, Windsurf, VS Code y otros clientes modernos soportan servidores MCP remotos por URL. Agregá Avalio a tu archivo de configuración MCP (en Cursor: ~/.cursor/mcp.json):
{
"mcpServers": {
"avalio": {
"url": "https://avalio.com.ar/api/mcp",
"headers": {
"Authorization": "Bearer avk_live_xxxxxxxxxxxxxxxxxxxx"
}
}
}
}Guardá, reiniciá el cliente y pedile algo como «¿Qué riesgo tiene el CUIT 30-70000004-0?». El agente va a llamar a riesgo_cliente solo.
Conectar en Claude
En Claude (web o escritorio) agregá un conector personalizado y pegá la URL del servidor https://avalio.com.ar/api/mcp, con tu clave como token. Si tu versión de Claude de escritorio todavía usa el archivo claude_desktop_config.json (que lanza servidores por comando), conectá el servidor remoto con el puente mcp-remote:
{
"mcpServers": {
"avalio": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://avalio.com.ar/api/mcp",
"--header", "Authorization:${AUTH}"],
"env": { "AUTH": "Bearer avk_live_xxxxxxxxxxxxxxxxxxxx" }
}
}
}(Se pasa el header por variable de entorno AUTH porque algunos puentes no aceptan espacios dentro del valor del --header.) El mismo patrón —URL + Bearer, o mcp-remote para clientes que solo hablan stdio— sirve para ChatGPT (modo desarrollador / conectores), Continue, Zed y cualquier cliente compatible con MCP.
Probar la conexión
Sin credenciales, un GET al endpoint describe el servidor y sus herramientas (útil para verificar que responde):
curl https://avalio.com.ar/api/mcpPara listar las herramientas por el protocolo, un POST JSON-RPC:
curl -X POST https://avalio.com.ar/api/mcp \
-H "Content-Type: application/json" \
-d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'Sandbox: CUIT de prueba
Con una clave avk_test_ estos CUIT ficticios devuelven cada caso canónico, siempre igual, sin tocar el BCRA ni consumir crédito. Ideales para probar el agente antes de pasar a producción:
30700000016AprobarEmisor sin antecedentes negativos.30700000024RevisarSituación 3 en la Central de Deudores del BCRA.30700000032RevisarCon cheques rechazados impagos.30700000040RechazarFigura en la base APOC de ARCA.30700000059RechazarEdicto concursal en el Boletín Oficial.30700000067RechazarCUIT dado de baja en el padrón de ARCA.30700000075RevisarBCRA caído: datos de respaldo (no cobra).Preguntas frecuentes
¿Cómo conecto ChatGPT o Claude a datos de riesgo de cheques de Argentina?
Avalio expone un servidor MCP (Model Context Protocol) en https://avalio.com.ar/api/mcp. Agregás esa URL como conector en Claude, ChatGPT (modo desarrollador), Cursor o cualquier cliente MCP, con tu API key de Avalio como Bearer, y el asistente queda con tres herramientas: riesgo_cliente, analizar_cheque y consultar_cuit.
¿Necesito programar para usar el MCP de Avalio?
No. Se configura una sola vez con la URL del servidor y tu clave; después le pedís el riesgo de un CUIT o de un cheque en lenguaje natural y el agente llama a Avalio solo.
¿Puedo probarlo gratis?
Sí. Con una clave de prueba (avk_test_) los CUIT de sandbox responden gratis y siempre igual, sin tocar el BCRA ni consumir créditos. Al crear tu cuenta además te damos 10 consultas reales gratis.
¿Qué datos devuelve?
Identidad del CUIT (nombre, estado en ARCA), un score de riesgo de 0 a 100, una decisión explicable (aprobar, revisar o rechazar), un índice orientativo de cobro y las fuentes oficiales con la fecha del dato (BCRA, ARCA, Boletín Oficial).
Más
Documentación completa de la API REST (endpoints, errores, idempotencia, webhooks firmados, SDKs): /desarrolladores. Especificación OpenAPI 3.1: /api/v1/openapi.
Conectá tu IA a Avalio
Creá tu cuenta gratis, generá una clave de API y conectá el servidor MCP en minutos. Sin tarjeta.
Crear cuenta gratis¿Dudas de integración? Escribinos.