# IA, bots y datos abiertos

Multilistado comparte sus datos con asistentes de IA, bots de agentes y otros sitios. Sin registro para leer; con la key de tu cuenta, tu bot también publica y atiende prospectos.

Fuente: https://multilistado.mx/developers/ai · Actualizado: 2026-10-20 · Otro idioma: https://multilistado.mx/developers/ai.md?lang=en

## Servidor MCP

MCP (Model Context Protocol) es el estándar con el que Claude, ChatGPT, Cursor y los frameworks de agentes se conectan a servicios. Nuestro servidor:

| | |
|---|---|
| URL | `https://multilistado.mx/mcp` |
| Transporte | Streamable HTTP (JSON) |
| Autenticación | Ninguna para herramientas abiertas · `Authorization: Bearer pbm_…` para herramientas de agente |
| Límite | 120 solicitudes por minuto |

**Herramientas abiertas** (sin key): `search_listings`, `get_listing`, `get_agent`, `verify_agent` (padrones oficiales), `estimate_home_value` (Estimado Multilistado), `colonia_prices`, `suggest_places`.

**Herramientas de agente** (con tu key de [Portal → API e IA](https://multilistado.mx/portal/api-keys)): `my_account`, `my_listings`, `my_leads` (permiso de prospectos), `create_listing`, `update_listing`, `publish_listing`, `unpublish_listing` (permiso completo).

```bash
# Claude Code
claude mcp add --transport http multilistado https://multilistado.mx/mcp
# con tu cuenta de agente
claude mcp add --transport http multilistado https://multilistado.mx/mcp --header "Authorization: Bearer pbm_…"
```

En **Claude** (web o escritorio): Configuración → Conectores → Agregar conector personalizado → `https://multilistado.mx/mcp`. En **ChatGPT** y otros clientes con soporte MCP, usa la misma URL. Para frameworks propios, envía JSON-RPC 2.0 por `POST`:

```bash
curl -s https://multilistado.mx/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"verify_agent","arguments":{"q":"Galarza"}}}'
```

## API de datos abiertos

Lo mismo por REST, sin key, con CORS abierto: `https://multilistado.mx/api/open/v1` · [OpenAPI](https://multilistado.mx/api/open/v1/openapi.json)

| Endpoint | Qué devuelve |
|---|---|
| `GET /listings?city=Tijuana&op=sale&type=house` | Propiedades de agentes verificados (filtros: q, city, state, colonia, type, op, min_price, max_price, currency, beds_min, bbox, sort, page) |
| `GET /listings/{slug}` | Ficha completa con el Estimado Multilistado |
| `GET /agents/verify?q=<nombre o folio>` | Coincidencias en los padrones estatales oficiales y cuentas verificadas |
| `GET /agents/{slug}` | Perfil público del agente y sus propiedades |
| `GET /estimate?type=house&m2_built=150&bedrooms=3&city=Tijuana&colonia=Playas` | Rango de valor (USD y MXN) con precios de lista cercanos |
| `GET /prices/colonias?municipality=Rosarito` | Mediana, mitad central y USD/m² por colonia |
| `GET /places?q=play` | Ciudades y colonias |

```bash
curl -s "https://multilistado.mx/api/open/v1/agents/verify?q=Galarza"
```

## Keys de agente para tu bot

En [Portal → API e IA](https://multilistado.mx/portal/api-keys) crea una key por bot, con el permiso mínimo: **solo lectura** (tu perfil y tus propiedades), **lectura + prospectos**, o **completo** (crear, editar y publicar propiedades). Las keys se revocan al instante. La misma key sirve para la [API REST v1](https://multilistado.mx/developers/api) y para el servidor MCP.

## Qué compartimos y qué no

- **Sí:** propiedades publicadas por agentes verificados (salvo las que el agente excluyó de otros sitios), perfiles públicos de agentes, coincidencias de los padrones oficiales (nombre, folio, estado, vigencia y enlace oficial), el Estimado Multilistado y estadísticas de precios por colonia.
- **No:** datos de compradores, verificaciones de identidad, convenios, prospectos de otros agentes, teléfonos o correos de los padrones, ni volcados de anuncios de otros portales (solo estadísticas agregadas).
- **Atribución:** cita y enlaza multilistado.mx; la ficha en el sitio es la información vigente (precios y disponibilidad cambian).