# Interfaces para agentes de Financiera Inmobiliaria

Agencia inmobiliaria en Gandia (Valencia, España) especializada en compra, venta y alquiler de pisos, casas, chalets, locales y garajes en la comarca de la Safor.

Todo lo que se describe aquí es público, de solo lectura (salvo `solicitar_contacto`)
y no requiere autenticación. Condiciones de uso y límites: https://financierainmobiliaria.es/auth.md

## 1. Servidor MCP — `https://financierainmobiliaria.es/mcp`

Transporte Streamable HTTP (JSON-RPC 2.0 sobre POST, respuesta `application/json`).
Sin sesión: cada petición es independiente.

```bash
curl -s https://financierainmobiliaria.es/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"buscar_inmuebles",
                 "arguments":{"texto":"piso con garaje","localidad":"Gandia","operacion":"venta","precio_max":150000}}}'
```

Herramientas disponibles:

| Herramienta | Tipo | Descripción |
| --- | --- | --- |
| `buscar_inmuebles` | lectura | Busca inmuebles publicados por Financiera Inmobiliaria en Gandia y la comarca de la Safor (Valencia, España). Admite consulta en lenguaje natural y filtros por operación, tipo, población, precio y habitaciones. Devuelve solo inmuebles disponibles, con su URL en la web. |
| `obtener_inmueble` | lectura | Devuelve la ficha completa de un inmueble publicado (precio, superficie, habitaciones, características, descripción e imágenes) a partir de su id, su slug de URL o su referencia. |
| `listar_localidades` | lectura | Lista las poblaciones con inmuebles publicados y cuántos hay en cada una. Útil antes de filtrar por localidad. |
| `listar_tipos` | lectura | Lista los tipos de inmueble y de operación válidos para los filtros de buscar_inmuebles. |
| `datos_agencia` | lectura | Datos de contacto, dirección, horario y zona de actuación de la agencia inmobiliaria. |
| `solicitar_contacto` | escritura | Registra una solicitud de información o de visita para que la agencia llame al interesado. Requiere consentimiento explícito de la persona: no la uses sin que haya pedido ser contactada y haya facilitado su nombre y teléfono reales. |

Tarjeta del servidor: https://financierainmobiliaria.es/.well-known/mcp/server-card.json

## 2. Agente A2A — `https://financierainmobiliaria.es/a2a`

JSON-RPC 2.0, método `message/send`. Acepta una consulta en lenguaje natural y
devuelve un mensaje en Markdown más un artefacto JSON con los inmuebles.

```bash
curl -s https://financierainmobiliaria.es/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send",
       "params":{"message":{"role":"user","parts":[{"kind":"text","text":"piso de 3 habitaciones en venta en Gandia"}]}}}'
```

Tarjeta del agente: https://financierainmobiliaria.es/.well-known/agent-card.json

## 3. API REST — `https://financierainmobiliaria.es/api/web/…`

Especificación OpenAPI 3.1: https://financierainmobiliaria.es/openapi.json · catálogo RFC 9727: https://financierainmobiliaria.es/.well-known/api-catalog

- `GET /api/web/propiedades` — listado con filtros y paginación.
- `GET /api/web/propiedades/{slug}` — ficha de un inmueble.
- `GET /api/web/lookup` — tipos de operación e inmueble con sus ids.

## 4. Markdown para agentes

Cualquier página pública devuelve Markdown si la petición lleva `Accept: text/markdown`:

```bash
curl -H "Accept: text/markdown" https://financierainmobiliaria.es/inmuebles
```

Índice para LLMs: https://financierainmobiliaria.es/llms.txt · volcado completo: https://financierainmobiliaria.es/llms-full.txt

## 5. Skills

https://financierainmobiliaria.es/.well-known/agent-skills/index.json (Agent Skills Discovery 0.2.0)

## Contacto

+34962954065 · info@lapiramide10.es · Carrer d'Alcalá del Olmo, 8, 46701 Gandia (Valencia), España