La ficha catastral,
como una llamada a función.
cataster expone el Catastro como tres herramientas MCP. Tu agente pasa una dirección o un punto en el mapa y recibe JSON estable: referencia, superficies, año, uso y geometría de la parcela.
{
"referencia": "1426301VK4712N0001AB",
"direccion": "CALLE DE ALCALÁ 45",
"superficie_construida": 214,
"superficie_parcela": 779,
"anio_construccion": 1987,
"uso_principal": "Residencial",
"coef_participacion": 12.5,
"geometria": {
"srs": "EPSG:4326",
"tipo": "Polygon",
"coords": [[[-3.6934, 40.4191], …]]
}
}
Del token al JSON
en tres pasos.
Sin SDK propio ni claves que caducan a mitad de integración. Un endpoint MCP estándar que cualquier cliente compatible entiende.
Crea el token
Un token catastro_live_… asociado a tu cuenta. La cuota va ligada a él, no a tu IP, y solo se muestra una vez.
Conecta /mcp
Añade https://mcp.cataster.app/mcp a tu cliente con la cabecera Bearer. Sin instalar nada, sin proxy local.
Pregunta
El agente elige la herramienta y recibe la ficha. Si la dirección no resuelve, reintentamos por geometría y geocodificación.
{
"mcpServers": {
"cataster": {
"type": "http",
"url": "https://mcp.cataster.app/mcp",
"headers": {
"Authorization": "Bearer catastro_live_xxx"
}
}
}
}
{
"mcpServers": {
"cataster": {
"url": "https://mcp.cataster.app/mcp",
"headers": { "Authorization": "Bearer catastro_live_xxx" }
}
}
}
// ~/.cursor/mcp.json
from fastmcp import Client client = Client( "https://mcp.cataster.app/mcp", headers={"Authorization": "Bearer catastro_live_xxx"}, ) async with client: ficha = await client.call_tool( "catastro_from_address", {"provincia": "Madrid", "municipio": "Madrid", "via": "CALLE DE ALCALÁ", "numero": "45"}, ) print(ficha)
curl -X POST https://mcp.cataster.app/mcp \ -H "Authorization: Bearer catastro_live_xxx" \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "catastro_from_coordinates", "arguments": { "lat": 40.41967, "lng": -3.69312 } } }'
Tres funciones.
Ninguna sorpresa.
JSON tipado y estable. Lo que tu prompt espera es exactamente lo que llega, campo a campo.
| Herramienta | Qué devuelve | Parámetros |
|---|---|---|
| catastro_from_address Dirección → ficha | De una dirección postal a la referencia catastral de 20 caracteres, con superficies, año, uso y unidades constructivas del inmueble. |
provinciamunicipiovianumeroplantapuerta |
| catastro_from_coordinates Punto → polígono | Un punto en WGS84 y devuelve la parcela que lo contiene: referencia, polígono completo en el SRS que pidas y metadatos del inmueble. |
latlngsrs |
| catastro_html_view Ficha → documento | Una vista HTML autocontenida con mapa Leaflet y la ficha maquetada. Ideal para pegar en un chat o adjuntar a un informe. |
address | lat/lnglang |
Nosotros domamos
la OVC.
La API pública del Catastro funciona, pero tiene carácter. cataster normaliza todo lo que duele para que tu agente reciba siempre la misma forma.
- Referencias normalizadas de 14 a 20 caracteres, sin adivinar el dígito de control.
- El error silencioso
cuerr=16se detecta: nunca pasa por respuesta buena. - Geometría WFS INSPIRE con límite de bytes y simplificación para respuestas ligeras.
- Cache de 24 h y reintentos con backoff: menos carga para la OVC, más velocidad para ti.
- Geocodificación de respaldo con Nominatim cuando la dirección viene incompleta.
Empieza gratis.
Paga cuando escales.
Cuota por token, sin acumulación de consultas no usadas y sin letra pequeña. Cambio de plan cuando quieras.
Free
- Las tres herramientas
- Un token activo
- Playground web incluido
- Atribución del Catastro
Pro
Popular- Cinco tokens y rotación
- Cache propio por token
- Vista HTML y export de geometría
- Soporte por email
Business
- 10.000 consultas / mes
- Tokens ilimitados por equipo
- Webhooks y registro de uso
- Prioridad de cola y SLA
- Uso extra a 0,02 EUR / consulta
Lo que suelen
preguntar.
Y si falta algo, escríbenos: contestamos personas.
¿Es un servicio oficial del Catastro?
No. cataster es un producto independiente que consulta la API pública de la Dirección General del Catastro. Los datos no sustituyen un certificado catastral ni una nota simple registral.
¿Puedo autoalojarlo?
Sí. El núcleo del servidor es MIT y se despliega con Docker. El portal, la facturación y el middleware de cuotas son la parte gestionada que ofrecemos aquí.
¿Qué pasa si la OVC va lenta o falla?
Cache de 24 horas, reintentos con backoff y degradación elegante: recibes un error tipado y explicable que tu agente puede comunicar, no un timeout mudo.
¿Guardáis mis consultas?
Solo el registro de uso necesario para la cuota (90 días, agregado después). No almacenamos el contenido de tus conversaciones ni entrenamos nada con ellas.
Un token y tu agente
ya consulta el Catastro.
Prueba con una dirección real. Menos tiempo que leer la documentación.