Spain's cadastre API is SOAP from 2003, so I built a JSON wrapper (+MCP)

guillermofc2 pts0 comments

Predio — El Catastro español, en JSON limpio.Saltar al contenidoEntrarEmpezar gratis nativo (disclosure accesible). Oculto en md+. -->

Para proptech, inmobiliarias y agentes de IA · REST + MCP<br>El Catastro español, en JSON limpio.<br>Resuelve y enriquece cualquier inmueble español y recibe JSON estructurado y versionado — sin pelearte con el SOAP del Catastro.<br>Resuelve por referencia catastral, coordenadas o dirección<br>JSON estructurado y versionado — urbano y rústico, misma forma<br>REST y MCP — mismo core, errores en JSON nunca XML<br>Pago por uso, sin tarjeta — primera llamada en 2 minutos<br>Empezar gratisVer la API<br>Sin tarjeta. Free-tier de 250 créditos/mes para probar antes de conectar la billetera.

Tu primera llamada<br>RESTMCPRespuesta<br>curl https://api.prediohq.com/v1/inmueble/9872023VH5797S0001WX \<br>-H "x-api-key: $PREDIO_API_KEY"

78,9 M<br>Bienes inmuebles del territorio común (Catastro, ene. 2026)

Urbano + rústico<br>~40,2 M urbanos · ~38,7 M rústicos, misma salida

Oficial<br>Datos de la Sede Electrónica del Catastro (DGC)

3 formas<br>Por referencia, coordenadas o dirección

/v1<br>Contrato versionado, errores en JSON

Serve-stale<br>Resiliente si la fuente oficial cae

01<br>El dato es público; consumirlo, no<br>Los datos catastrales son públicos, pero difíciles de consumir por máquinas : SOAP/XML pesado, errores que no respetan los códigos HTTP y un esquema pensado para humanos. Tu producto proptech —o el agente que evalúa un inmueble a mitad de tarea— quema tiempo y tokens, y se rompe.<br>Predio te los da limpios, estructurados y predecibles — para que tu agente no se ahogue en el dato. Misma forma para urbano y rústico, errores en JSON, y un dato cacheado marcado stalesi la fuente cae.

02<br>Resuelve por…<br>Tres entradas, la misma salida normalizada (clase, uso, m² construidos, año, dirección, desglose). Autentícate con tu cabecera x-api-key; los errores de negocio no cobran.<br>Por referencia catastral<br>La RC de 20 caracteres → el inmueble.<br>curl https://api.prediohq.com/v1/inmueble/9872023VH5797S0001WX \<br>-H "x-api-key: $PREDIO_API_KEY"<br>Por coordenadas<br>lat/lon (WGS84 o ETRS89) → el inmueble que contiene el punto.<br>curl "https://api.prediohq.com/v1/inmueble/by-coords?lat=41.3915&lon=2.1620" \<br>-H "x-api-key: $PREDIO_API_KEY"<br>Por dirección<br>Provincia, municipio, vía y número (inmueble urbano).<br>curl "https://api.prediohq.com/v1/inmueble/by-address?province=CIUDAD+REAL&municipality=SANTA+CRUZ+DE+MUDELA&streetType=CL&streetName=GLORIA&streetNumber=51" \<br>-H "x-api-key: $PREDIO_API_KEY"

Mismo core por REST o MCP. Lee el llms.txty la spec OpenAPI, conecta y recibe JSON listo para encadenar.

03<br>Para agentes, primero<br>Descubrible y nativo (MCP)<br>Servidor MCP listo para Claude, GPT y tu agente: la herramienta aparece y se invoca sola, con su JSON Schema.<br>Endpoint MCP →<br>REST espejo (/v1)<br>Mismo dominio, contrato versionado y estable. Para todo lo que no hable MCP, con errores predecibles en JSON.<br>Spec OpenAPI →<br>Descubrimiento AEO<br>llms.txt, precios legibles por máquina y la spec OpenAPI servidos desde el dominio. Evalúa antes de pagar.<br>llms.txt →

Nuevo · early access<br>ParcelGuard — las afecciones de una parcela, por referencia catastral<br>Inundabilidad (SNCZI), Red Natura 2000, costas y vías pecuarias en un JSON con fuente y fecha por capa: el pre-screening de una due diligence de suelo, sin abrir cinco visores. Pago por informe.

Conocer ParcelGuardVer informe real

04<br>Precios sin sorpresas<br>Pago por uso: 1 crédito por respuesta con éxito , sea cual sea el endpoint. El €/llamada baja en los packs grandes. Packs prepago vía Stripe; X402 como fast-follow.

Ver precios completos<br>Free<br>0€<br>250 créditos/mes<br>Para sandbox y diagnóstico antes de conectar la billetera.

Mini

5€<br>2500 créditos<br>≈ 0,002€/llamada

Starter

9€<br>5000 créditos<br>≈ 0,0018€/llamada

Growth<br>Popular<br>29€<br>25.000 créditos<br>≈ 0,00116€/llamada

Scale

99€<br>150.000 créditos<br>≈ 0,00066€/llamada

1 crédito = 1 respuesta con éxito. Los errores de negocio (404/422) no cobran; cache hits y serve-stale sí (precio por valor). Versión legible por máquina en/pricing.json.

05<br>Preguntas frecuentes<br>¿Qué pasa si me quedo sin saldo?<br>El gate de créditos responde 402 (pago requerido); no se corta a mitad de respuesta. Con auto-recarga activada, recargas sola al cruzar el umbral; sin ella, compras un pack y sigues.

¿Qué cobertura tiene?<br>Territorio común de España, urbano y rústico. Excluye País Vasco y Navarra, que tienen catastro foral propio.

¿Cuándo se consume un crédito?<br>1 crédito por respuesta con éxito (200 con cuerpo). Los errores de negocio (404 no encontrado, 422 entrada inválida) no cobran. Las respuestas cacheadas y el serve-stale sí cobran: pagas por el valor, no por nuestro coste.

¿Puedo redistribuir los datos del Catastro?<br>Son datos públicos no protegidos de la Dirección General del Catastro, reutilizables conforme a su licencia. Predio es un servicio no oficial; revisa la licencia de la DGC para tu caso de uso.

¿Cómo de actualizados están los datos?<br>Predio consulta la fuente oficial (Sede Electrónica del...

json para inmueble catastro errores llamada

Related Articles