BCRA Central de Deudores — MCP

Conector MCP sobre la API pública del Banco Central de la República Argentina para consultar situación crediticia por CUIT/CUIL/CDI.

• Fuente: https://api.bcra.gob.ar/CentralDeDeudores/v1.0
• Consulta web equivalente: https://www.bcra.gob.ar/situacion-crediticia/
• Autenticación: no requerida
• Costo: gratuito
• Manual oficial: https://www.bcra.gob.ar/archivos/Catalogo/Content/files/pdf/central-deudores-v1.pdf

Herramientas expuestas

Tool	Qué devuelve
bcra_estado	Health-check. No consulta datos de ninguna persona.
bcra_deudas	Situación crediticia del último período informado, entidad por entidad.
bcra_deudas_historicas	Serie de 24 meses + cálculo de tendencia (deterioro / mejora / estable).
bcra_cheques_rechazados	Cheques rechazados, causal, monto y estado de la multa.
bcra_informe_consolidado	Los tres anteriores en una llamada, con bloque de alertas graduadas.

Todas aceptan el CUIT con o sin guiones o puntos.

Valor agregado sobre la API cruda

• Decodifica el campo situacion (1 a 5) a su etiqueta normativa según el T.O. de Clasificación de Deudores del BCRA.
• Convierte los montos: el BCRA informa en miles de pesos. Se devuelven ambos valores.
• Levanta banderas explícitas para los encuadres especiales, en particular situacionJuridica (concurso, quiebra, gestión judicial o concordato), que es el dato de mayor relevancia para el Fisco.
• Calcula deuda total por período y peor clasificación vigente.
• Detecta deterioro de la clasificación a lo largo de la serie histórica.

Despliegue en Railway

1. Crear repositorio nuevo en GitHub (cuenta patricioargota-collab), por ejemplo bcra-deudores-mcp, y subir los cuatro archivos: server.py, requirements.txt, Dockerfile, .gitignore.

   Cuidado con el artefacto de renombrado del navegador (server (3).py). Si aparece, crear el archivo a mano en el editor web de GitHub y pegar el contenido.

2. En Railway: New Project → Deploy from GitHub repo y seleccionar el repositorio.
3. Railway detecta el Dockerfile. No hace falta configurar variables de entorno: PORT la inyecta Railway automáticamente.
4. Settings → Networking → Generate Domain. Queda algo como https://bcra-deudores-mcp-production.up.railway.app.
5. En Claude, agregar el conector con la URL terminada en /mcp: https://<dominio>.up.railway.app/mcp
6. Abrir una conversación nueva y llamar bcra_estado para validar el handshake.

Notas de configuración ya resueltas en el código

• FastMCP(..., host="0.0.0.0", transport_security=TransportSecuritySettings(enable_dns_rebinding_protection=False))
• Transporte streamable-http (con guion).
• El puerto se fija vía mcp.settings.port, no como argumento de mcp.run().
• Sin instrucción VOLUME en el Dockerfile.

Cold start

Igual que los otros conectores del ecosistema, Railway duerme el servicio. Si falla el handshake, abrir una conversación nueva: la llamada previa despierta el servidor y la sesión nueva captura el catálogo completo.

Prueba local opcional

Para probar desde el contenedor de Claude hay que agregar api.bcra.gob.ar al allowlist de egreso de red. Sin eso, la lógica interna se puede testear pero las llamadas HTTP devuelven Host not in allowlist.

python server.py       # levanta en :8000

Advertencias de uso

1. La difusión de estos datos no implica conformidad del BCRA. La información la suministran las entidades informantes.
2. No acredita deuda tributaria ni patrimonio. Solo refleja financiaciones del sistema financiero, más cheques rechazados.
3. Ley 25.326. Los campos enRevision (art. 16 inc. 6) y procesoJud (art. 38 inc. 3) señalan datos impugnados. Los derechos de rectificación se ejercen ante la entidad cedente, no ante el BCRA ni ante el organismo consultante.
4. Para incorporar a un expediente administrativo, verificar contra la consulta web oficial y dejar constancia de fecha y hora de la consulta. La salida del conector es insumo de trabajo, no constancia oficial.