Claude y Asistentes de IA (MCP)

Habla con la API de RED Atlas en lenguaje natural. Nuestro servidor MCP (Model Context Protocol) remoto permite que asistentes de IA como Claude consulten datos de mercado en vivo, generen valuaciones y lean esta documentación por ti, usando tu propia cuenta y plan.

URL del conector

Agrega esta URL donde tu cliente de IA pida un servidor MCP remoto:

https://apiv3.atlas.red/external-api/v1/mcp

Autenticación y facturación

Al conectar, inicias sesión con tu email y contraseña del portal de desarrolladores (OAuth). Ninguna API key queda expuesta al asistente. La conexión está ligada a tu cuenta y puede revocarse en cualquier momento.

Las llamadas del asistente se miden igual que las llamadas normales a la API: consumen los créditos mensuales de tu plan, y las herramientas de agregación y premium cuestan más por llamada que leer un registro. Puedes auditar todo en el panel de Usage.

Conectar desde tu asistente de IA

El conector sigue el estándar abierto MCP, así que la misma URL funciona en todos los asistentes. Se agrega una vez por espacio de trabajo; luego cada usuario inicia sesión con su propia cuenta del portal de desarrolladores.

Claude (web, escritorio, móvil)

Abre Configuración > Conectores y busca RED Atlas API en el directorio de conectores: está publicado, así que no hay URL, Client ID ni Secret que pegar.
Haz clic en Conectar, inicia sesión con el correo y la contraseña de tu cuenta del portal de desarrolladores y haz clic en Authorize.
En un chat, abre el menú del conector y habilita las herramientas que quieras: las de consulta (solo lectura) pueden quedar en «permitir siempre»; la creación de reportes pide confirmación cada vez.

Si prefieres agregarlo por URL (un cliente propio, o cualquier asistente que no lea el directorio de Claude): elige Agregar conector personalizado, pega la URL del conector de arriba y deja OAuth Client ID y Secret vacíos.

En planes Claude Team/Enterprise solo un Owner de la organización puede agregar el conector (Configuración de la organización > Conectores). Mantén habilitado Individual sign-in para que cada miembro conecte con su propia cuenta de RED Atlas.

Claude Code

Un solo comando registra el conector por URL; el CLI no usa el directorio. La autenticación se abre en tu navegador:

claude mcp add --transport http redatlas https://apiv3.atlas.red/external-api/v1/mcp
# then, inside a session: /mcp -> redatlas -> Authenticate

ChatGPT (OpenAI)

En ChatGPT, abre Configuración > Conectores (disponible en Plus, Pro, Business y Enterprise) y elige Agregar conector personalizado / servidor MCP.
Pega la URL del conector; deja en blanco cualquier client id/secret.
Autoriza con tu cuenta del portal de desarrolladores y luego habilita el conector en un chat o proyecto.

Gemini

Gemini CLI se conecta por MCP. Agrega el servidor a tu ~/.gemini/settings.json (o a un .gemini/settings.json del proyecto); el inicio de sesión OAuth se abre en el navegador la primera vez.

{
  "mcpServers": {
    "redatlas": {
      "httpUrl": "https://apiv3.atlas.red/external-api/v1/mcp",
      "oauth": { "enabled": true }
    }
  }
}

Grok y X

En Grok (grok.com) o X, abre Configuración > Conectores > Nuevo conector > Personalizado.
Pega la URL del conector como servidor MCP remoto.
Completa el inicio de sesión OAuth con tu cuenta del portal de desarrolladores.

Smithery

Smithery es un directorio público de MCP cuyo gateway conecta tu cliente con este servidor, así que funciona desde cualquier cliente compatible sin pegar una URL. La ficha es RED Atlas API en Smithery.

Abre la ficha y pulsa Connect — no hay nada que configurar, porque el acceso se negocia por OAuth y no con una API key.
Inicia sesión con el correo y la contraseña de tu portal de desarrolladores y pulsa Authorize. Las llamadas se miden con los mismos créditos del plan que en cualquier otro cliente.

Herramientas disponibles

El conector expone la superficie documentada de la API como herramientas, listadas abajo. El asistente las elige automáticamente según tu pregunta. La lista de herramientas se descubre por MCP al conectar, así que las que agreguemos aparecen sin cambios de tu lado — reconecta el conector si un asistente sigue con una lista anterior.

Herramienta	Descripción
`atlas_query_data`	Lista registros (propiedades, listings, parcelas, ...) con filtros, orden y paginación. Admite el filtro de radio near y el de viewport bbox. Consume créditos por registro.
`atlas_get_record`	Obtiene un registro por id. Consume créditos.
`atlas_get_stats`	Estadísticas agregadas de mercado, opcionalmente acotadas a un radio (near) o a un viewport de mapa (bbox). Costo fijo por llamada, que varía según la entidad (ver atlas_pricing).
`atlas_market_report`	Perfila un mercado en una sola llamada: estadísticas, tendencia de 12 meses y un desglose ordenado opcional. Costo fijo en créditos.
`atlas_market_profile`	Perfil de mercado completo de una ubicación (mercado, región, ciudad, barrio): medianas de venta y alquiler con series mensuales, inventario, días en el mercado, rentabilidad, demografía y noticias locales en una sola llamada. Costo fijo en créditos.
`atlas_top_by`	Ordena y cuenta registros por una dimensión, por ejemplo anuncios por municipio o por inmobiliaria. Costo fijo en créditos.
`atlas_pivot`	Cruza dos dimensiones; cualquiera de los ejes puede ser una fecha, lo que devuelve una serie temporal por grupo. Costo fijo en créditos.
`atlas_velocity`	Qué tan rápido se mueve un mercado: registros nuevos de este período frente al anterior, con el cambio absoluto y porcentual. Costo fijo en créditos.
`atlas_search`	Búsqueda de texto libre entre entidades. Consume créditos por llamada.
`atlas_lookup_location`	Resuelve nombres de ciudad, barrio y región en ids de filtro. Gratis.
`atlas_list_entities`	Descubre qué tipos de entidad ofrece un mercado. Gratis.
`atlas_get_parcel_contacts`	Personas que RED Atlas tiene para un predio (corredores, profesionales de permisos): nombres, roles y procedencia, nunca teléfonos ni correos. Sin créditos; solo plan Enterprise.
`atlas_request_contacts`	Solicita los teléfonos y correos de esas personas. Devuelve un recibo; los datos van a tu repositorio de RED Atlas y a tu correo, nunca al chat. Cobra el precio de contactos por cada contacto que tu organización aún no desbloqueó. Solo plan Enterprise.
`atlas_enrich_contacts`	Enriquecimiento de contactos (skip-trace) para una persona o dirección. Devuelve a quién encontró y un recibo; los datos van a tu repositorio. Cobra el precio contacts_enriched solo cuando desbloquea a alguien nuevo; sin coincidencia cuesta 0. Solo plan Enterprise.
`atlas_create_avm_report`	Inicia un informe de valoración automática (AVM). 10 créditos, reembolsados si el modelo se abstiene o el informe falla. El informe empieza en processing: obtenlo con atlas_get_report.
`atlas_create_comparables_report`	Genera un reporte de comparables de mercado. 6 créditos.
`atlas_comparable_sales`	Ventas registradas comparables cerca de una propiedad, con distancia, precio por m2 y las medianas ya calculadas. Ejecuta el reporte de comparables y espera el resultado, así que es una sola llamada en vez de crear y consultar. 6 créditos.
`atlas_asset_class_report`	Perfila una clase de activo en una sola llamada: agregados de venta y renta, corte por clase de edificio, principales municipios, velocidad y el stock total de ese uso. Se cobra como las ~7 llamadas de agregador que ejecuta.
`atlas_list_reports`	Lista tus reportes generados. Gratis.
`atlas_get_report`	Obtiene el resultado de un reporte y su enlace compartible. Gratis.
`atlas_read_docs`	Lee esta documentación para que las respuestas citen parámetros reales. Gratis.
`atlas_my_plan`	El plan de esta cuenta, sus permisos y el saldo de créditos en vivo. Gratis.
`atlas_pricing`	El catálogo completo de precios: el precio y los créditos incluidos de cada plan, y el costo en créditos de cada entidad, agregación, campo adicional, llamada de contactos, enriquecimiento e informe. Gratis.
`atlas_change_plan`	Cambia el plan de la cuenta. Primero muestra una vista previa y no cambia nada hasta que confirmes.
`atlas_set_overage`	Activa o desactiva el excedente facturado, para que las llamadas sigan funcionando cuando se acaben los créditos. Primero muestra una vista previa y no cambia nada hasta que confirmes.

Cosas que puedes preguntar

¿Cuántas casas están en venta en San Juan por menos de $500,000?
Genera un AVM para esta dirección y dame el valor estimado.
Escribe un script de Python que traiga las transacciones del mes pasado en Condado.

Otros clientes de IA

El conector sigue el estándar abierto MCP y también funciona con otros clientes compatibles, como los conectores personalizados de ChatGPT e IDEs con MCP. Apunta el cliente a la misma URL e inicia sesión con tu cuenta del portal de desarrolladores.