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 12 herramientas. El asistente las elige automáticamente según tu pregunta.

Herramienta	Descripción
atlas_query_data	Lista registros (propiedades, listings, parcelas, ...) con filtros, orden y paginación. Consume créditos por registro.
atlas_get_record	Obtiene un registro por id. Consume créditos.
atlas_get_stats	Estadísticas agregadas de mercado. Costo fijo en créditos (5-15 según la entidad).
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_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	Enriquecimiento de contactos de parcela. 3 créditos fijos por llamada, sin importar cuántos contactos regresen.
atlas_create_avm_report	Genera un reporte de valuación automática (AVM). 10 créditos en JSON, 15 con el PDF.
atlas_create_comparables_report	Genera un reporte de comparables de mercado. 6 créditos.
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.

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.