model context protocol · catastro de españa

El Catastro,
en tu terminal.

cataster expone las tres consultas que necesitas del Catastro como herramientas MCP. Tu agente pasa una dirección o un punto y recibe JSON estable: referencia, superficies, año, uso y geometría.

Empezar gratis Ver instalación

MIT core Streamable HTTP 100 consultas/mes gratis sin tarjeta

~/proyectos — zsh

$ claude mcp add cataster \ --transport http \ --url https://mcp.cataster.app/mcp \ --header "Authorization: Bearer $CAT_TOKEN" ✔ cataster conectado · 3 herramientas disponibles $ mcp call catastro_from_coordinates \ --lat 40.41967 --lng -3.69312 { "referencia": "1426301VK4712N0001AB", "superficie_construida": 214, "anio_construccion": 1987, "uso_principal": "Residencial", "geometria": { "tipo": "Polygon", "srs": "EPSG:4326" } } ✔ 200 OK · 381 ms · cache 24 h $

zsh · cataster80×24

15,2 Mparcelas

380 msp50

3herramientas

0 €100 / mes

01

Instalación

Un token, un endpoint, cero dependencias locales. Cualquier cliente MCP compatible funciona sin configuración extra.

01

genera el token

Crea la cuenta y genera un token catastro_live_…. Se muestra una sola vez: la cuota va ligada a él, no a tu IP.

30 s

02

apunta al endpoint

Añade https://mcp.cataster.app/mcp a tu cliente con la cabecera Authorization: Bearer.

1 comando

03

pregunta en tu idioma

El agente elige la herramienta. Si la dirección no resuelve, reintentamos por geometría y geocodificación sin que lo notes.

listo

$ claude mcp add cataster \
    --transport http \
    --url https://mcp.cataster.app/mcp \
    --header "Authorization: Bearer catastro_live_xxx"

✔ cataster conectado · 3 herramientas

// claude_desktop_config.json
{
  "mcpServers": {
    "cataster": {
      "type": "http",
      "url": "https://mcp.cataster.app/mcp",
      "headers": {
        "Authorization": "Bearer catastro_live_xxx"
      }
    }
  }
}

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 }
    }
  }'

02

Herramientas

Respuestas tipadas y estables. Los campos no cambian de forma entre llamadas: tu prompt no se rompe.

nombre

devuelve

parámetros

catastro_from_addressdirección → ficha

De una dirección postal a la referencia catastral de 20 caracteres, con superficies, año, uso y unidades constructivas.

provinciamunicipiovianumeroplantapuerta

catastro_from_coordinatespunto → polígono

Un punto en WGS84 y devuelve la parcela que lo contiene: referencia, polígono completo y metadatos del inmueble.

latlngsrs

catastro_html_viewficha → documento

Vista HTML autocontenida con mapa Leaflet y la ficha maquetada. Útil para pegar en un chat o adjuntar a un informe.

address | lat/lnglang

03

Bajo el capó

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=16 se 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.
Errores tipados y accionables, no timeouts mudos que el modelo no sabe interpretar.

nota del autor

La OVC es un recurso público compartido. La cache y el rate limit no son funciones de pago disfrazadas: son la sostenibilidad del producto y el respeto al servicio del que todos dependemos.

Por eso el núcleo se publica bajo MIT y el código de la normalización está a la vista. Si quieres autoalojarlo, adelante.

04

Precios

Cuota por token, sin acumulación de consultas no usadas y sin letra pequeña. Cambio de plan cuando quieras.

plan

precio

incluye

free

0 € /mes

100 consultas · 1 token · playground web · atribución del Catastro

Crear cuenta

pro popular

12 € /mes

2.000 consultas · 5 tokens · cache por token · vista HTML · soporte email

Probar 14 días

business

59 € /mes

10.000 consultas · tokens ilimitados · webhooks · prioridad de cola · SLA

Hablar con nosotros

metered

0,02 € /consulta

Sin cuota mensual · facturación por uso · mismo endpoint y herramientas

Activar

05

Preguntas

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.

?¿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.

?¿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.

sin tarjeta · 100 consultas gratis

Un token y tu agente
ya consulta el Catastro.

Prueba con una dirección real. Menos tiempo que leer esta página entera.

Empezar gratis Documentación

El Catastro,en tu terminal.