Consulta las calles desde tu asistente.

Conexión

Transporte: Streamable HTTP. El endpoint de protocolo es distinto de esta página de documentación.

https://callejear.com/api/mcp

Cliente comprobado: @modelcontextprotocol/client 2.3.1. Protocolo: 2025-11-25. Versión desplegada: 0.1.0.

Comprobación externa: 2026-10-14T05:12:12.945Z. Esto acredita la conexión del SDK; no la compatibilidad con un asistente concreto.

Ejemplo para Node 22.22.x: instala el cliente fijado, guarda el código en consulta.mjs y ejecuta node consulta.mjs.

npm install --save-exact @modelcontextprotocol/[email protected]

import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client';

const client = new Client({ name: 'callejear-example', version: '1.0.0' });
try {
  await client.connect(new StreamableHTTPClientTransport(
    new URL('https://callejear.com/api/mcp')
  ));
  console.log(await client.callTool({
    name: 'callejear_get_coverage', arguments: {}
  }));
} finally {
  await client.close();
}

El piloto está diseñado para consultas públicas sin autenticación. No realiza acciones sobre inmuebles ni campañas, ni solicita credenciales de otros servicios.

Read-only MCP pilot for a verified subset of Madrid street records. Nearby-service counts describe partial observations around representative points, not whole streets or housing recommendations.

Un municipio, cobertura explícita

El conjunto contiene registros con identidad contrastada y punto asociado a un segmento de origen. Un registro no equivale a toda la vía. La selección no incluye todas las calles de Madrid.

• Registros de farmacia — recuento de registros.
• Registros de colegio — recuento de registros.
• Registros de supermercado — recuento de registros.
• Registros de biblioteca — recuento de registros.

Sin datos de seguridad, calidad educativa, frecuencia de transporte, precios inmobiliarios ni clasificación de mejores calles para vivir.

Cuatro herramientas de lectura

No se admiten filtros de métricas en esta versión. La búsqueda exige texto, no admite un inventario vacío y devuelve como máximo 20 resultados. Las dimensiones o radios desconocidos se rechazan; nunca se ignoran.

Ejemplos con registros del conjunto

1. Descubrir cobertura

callejear_get_coverage
{"city_id":"28079"}

2. Buscar una calle

callejear_search_streets
{"city_id":"28079","query":"Alcalá","limit":5}

3. Consultar su entorno

callejear_get_street_context
{"street_id":"legacy:calle:109907","radius_m":500,"dimensions":["pharmacy_records","school_records"]}

4. Comparar dos registros

callejear_compare_streets
{"street_ids":["legacy:calle:109907","legacy:calle:110074"],"radius_m":500}

Registros utilizados: Calle de Alcalá y Calle de Atocha. Son ubicaciones de referencia concretas; la comparación no elige una vivienda ni un ganador.

Qué significan los valores

• El entorno corresponde al punto representativo del registro, no a toda la calle.
• Distancias en línea recta; no son recorridos ni minutos caminando.
• Inventario local parcial de Madrid. En los bordes municipales pueden faltar servicios del municipio vecino.
• Se cuentan registros, no establecimientos únicos. No se conservó el tipo OSM y pueden existir representaciones duplicadas.
• La fecha individual del inventario de servicios se desconoce; no se ha verificado su actividad actual.
• Cero significa cero registros observados; no demuestra ausencia real de servicios.

partial indica que el inventario puede ser incompleto. null indica dato no disponible; no se sustituye por cero. Dos valores solo se comparan si comparten definición, radio, unidad y método.

La fecha de cálculo del paquete es 2026-10-13T21:16:25.756122+00:00. No es la fecha de actualización de los servicios. Cada fuente conserva por separado las fechas conocidas; las desconocidas permanecen vacías.

Límites de uso

Los límites se aplican también cuando se usa caché. Alcanzar la cuota global puede dejar temporalmente sin servicio a todos los clientes. El piloto puede desactivarse sin retirar las fichas públicas.

La cuota por origen agrupa direcciones IPv6 de la misma red /64. La búsqueda valida siempre los cursores y no usa caché. Comparar cinco registros con todas las dimensiones puede superar el tamaño permitido: si recibes response_too_large, repite la consulta con menos dimensiones.

Las llamadas MCP se miden separadas de las visitas web. No se registran prompts completos, consultas libres ni tokens en la analítica del piloto.

Fuentes y reutilización

Selección, cruce y recuentos elaborados por Callejear. El Ayuntamiento de Madrid y OpenStreetMap no patrocinan ni certifican este servicio.

El extracto derivado de OSM se ofrece bajo ODbL 1.0. Los datos municipales conservan atribución y CC BY 4.0.

• Conjunto de datos del piloto en JSON
• Registros OSM utilizados para los recuentos
• Aviso de fuentes, transformaciones y licencias

Responsable y contacto

Yoel Castaño Peón, Callejear. Para informar de un error, incluye el ID del registro y la versión de datos: [email protected].