ThinAir Geo

Servidor MCP para geocodificación, geocodificación inversa, enrutamiento de camiones con restricciones de materiales peligrosos y dimensiones, tráfico en vivo, clima, isocronas y búsqueda de lugares.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP ThinAir Geo

Dale a tu agente de IA conciencia geoespacial completa — geocodifica direcciones e intersecciones, traza rutas en múltiples modos (auto, camión, bicicleta, peatón), consulta tráfico y clima en vivo, dibuja polígonos de alcance y busca lugares. Resultados con puntuación de confianza para que tu agente sepa cuándo volver a preguntar. 19 herramientas vía MCP.

19 herramientas MCP · Geocodificación, rutas, tráfico, clima, lugares · Diseñado para flujos de trabajo de nivel flota

> geocode "Bayport Terminal"
✓ matched: Bayport Terminal, Harris County, TX, USA
✓ confidence: 1.0  (method: search_venue)
✓ coordinates: 29.61345, -95.00292

Parte de ThinAir

ThinAir Geo es la capa de inteligencia geoespacial detrás de los flujos de trabajo de flota de ThinAir: geocodificación, contexto de rutas, búsqueda de direcciones, visibilidad de áreas de servicio, inteligencia de mapas, tráfico, clima y alcance.

Producto alojado vs este repositorio

geo.thinair.co es el producto alojado de ThinAir.
Este repositorio es el paquete/indicador público MCP ligero para desarrolladores y clientes de agentes de IA.
El uso en producción puede requerir una cuenta de ThinAir, clave de API, conexión OAuth o un espacio de trabajo alojado.

Qué Hace

ThinAir Geo es un servidor de Protocolo de Contexto de Modelo (MCP) que brinda a los agentes de IA herramientas geoespaciales de pila completa — sin necesidad de integración de API. Coordenadas desde las que realmente puedes trazar rutas: precisión a nivel de intersección con puntuaciones de confianza, sin respaldos silenciosos (devuelve un resultado vacío en lugar de una suposición del centroide de la ciudad cuando hay incertidumbre).

Geocodificación — Directa, inversa, de intersección y por lotes (50/llamada). Los resultados incluyen confidence y method para que los agentes puedan ramificar según la calidad.
Rutas — Multiperfil: auto, camión, bicicleta, peatón, motocicleta. 10 ajustes preestablecidos específicos para camiones (furgón seco, plataforma, plataforma escalonada, tanque, camión de caja, portavehículos, sprinter, doble remolque, sobredimensionado) con restricciones nativas de materiales peligrosos / dimensiones / peso / tiempo-distancia.
Tráfico — Condiciones en tiempo real para más de 30 áreas metropolitanas de EE. UU.
Clima — Condiciones actuales y pronósticos.
Búsqueda y Exploración de Lugares — POI cercanos, descubrimiento de localidades con filtrado por población.
Isocronas — Polígonos de alcance por tiempo de conducción / caminata (múltiples bandas por llamada).

Enlaces del Producto

Producto: https://geo.thinair.co
Conectar / obtener clave: https://geo.thinair.co/connect
Documentación: https://geo.thinair.co/docs/getting-started
Precios: https://geo.thinair.co/checkout
ThinAir: https://thinair.co

Descubrimiento por Agentes

Los agentes autónomos y los rastreadores de directorios pueden descubrir las capacidades de este servidor sin analizar este README. Las tres superficies están activas y son servidas por el producto alojado:

Superficie	URL	Contiene
Tarjeta de agente (A2A)	`https://geo.thinair.co/.well-known/agent-card.json`	Versión del protocolo, endpoint, transporte, esquemas de autenticación y las 19 habilidades
Índice de habilidades	`https://geo.thinair.co/.well-known/skills.json`	Catálogo legible por máquina de las 19 herramientas
Guía LLM	`https://geo.thinair.co/llms.txt`	Orientación en texto plano para modelos de lenguaje

El endpoint MCP en sí es https://geo.thinair.co/mcp (HTTP transmisible; OAuth 2.1 sin clave, o Authorization: Bearer).

Herramientas

Herramienta	Descripción
`geocode`	Convierte direcciones, nombres de lugares o intersecciones a coordenadas
`reverse_geocode`	Convierte coordenadas a direcciones
`batch_geocode`	Geocodifica hasta 50 direcciones en una sola llamada (devuelve `geojson` FeatureCollection)
`directions`	Rutas giro a giro — auto, camión, bicicleta, peatón, motocicleta
`isochrone`	Polígonos de alcance por tiempo / distancia de viaje (multibanda)
`traffic`	Condiciones de tráfico en tiempo real
`weather`	Condiciones actuales y pronósticos
`search_places`	Encuentra POI cercanos por categoría (gasolina, carga, comida, alojamiento, …)
`explore`	Explora ciudades, vecindarios y lugares por región
`geocode_structured`	Geocodifica a partir de componentes de dirección discretos (campos de formulario / CRM) en lugar de texto libre
`resolve_intersection`	Resuelve una calle transversal nombrada (calle1 × calle2) a una coordenada con puntuación de confianza
`distance_matrix`	Distancias por carretera + tiempos de viaje para cada par origen → destino (≤ 625 pares)
`locate`	Ajusta una coordenada a la red vial — nombre de carretera, clase, límite de velocidad, legalidad, zona horaria, elevación del punto
`map_match`	Ajusta un rastro GPS crudo (2–100 puntos) a la ruta precisa por carretera realmente recorrida
`trace_attributes`	Atributos de carretera por segmento (nombres, clases, límites de velocidad, superficies) a lo largo de un rastro ajustado
`geofence_contains`	Prueba de punto en polígono contra un polígono GeoJSON (un booleano por punto)
`place_get`	Busca un lugar por su id estable de ThinAir (`ta_place_…` / `ta_intersection_…`)
`quota`	Inspecciona tu plan actual, uso diario y capacidad restante (gratis, nunca debita)
`issue_api_key`	Genera una nueva clave de API para el tenant actual (cuenta como 1 consulta)

Perfiles de Vehículos de Camión

Pasa cualquiera de estos como vehicle_profile en directions o isochrone para establecer dimensiones automáticamente:

Perfil	Dimensiones / Caso de uso
`DRY_VAN_53`	Furgón seco de 53′ — carga estándar de EE. UU. (predeterminado)
`FLATBED_48`	Plataforma de 48′, altura de carga 14′
`FLATBED_40`	Plataforma de 40′, regional / especializado
`STEP_DECK`	Plataforma escalonada / de caída, espacio libre de cubierta superior 11′3″
`TANKER`	Tanque de líquido/gas (combínalo con `hazmat=true`)
`BOX_TRUCK_26`	Camión de caja de 26′, entrega local
`AUTO_CARRIER`	Portavehículos / transporte de autos
`SPRINTER_VAN`	Furgón de carga, última milla (9′ de alto)
`DOUBLE_TRAILER`	Doble remolque de 28′, LTL de larga distancia (92′ total)
`OVERSIZE`	Cargas sobredimensionadas permitidas — anula dimensiones por viaje

Los parámetros individuales (truck_height, truck_weight, truck_length, axle_count, etc.) anulan el ajuste preestablecido.

Inicio Rápido

Claude Desktop, Cursor, Windsurf — OAuth (recomendado, sin clave)

Agrega a la configuración MCP de tu cliente (p. ej. ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "thinair-geo": {
      "url": "https://geo.thinair.co/mcp"
    }
  }
}

El flujo OAuth se completa en el primer uso — no se requiere configuración manual de tokens. Nivel gratuito: 15 solicitudes/día, sin tarjeta.

Clave de API (para clientes sin OAuth)

{
  "mcpServers": {
    "thinair-geo": {
      "url": "https://geo.thinair.co/mcp",
      "headers": {
        "Authorization": "Bearer ta_live_..."
      }
    }
  }
}

Obtén una clave en https://geo.thinair.co/connect.

npx (CLI / scripts)

npx -y @thinairtelematics/geo

Imprime un bloque de configuración en la salida estándar para tu cliente. Misma opción sin clave OAuth que la anterior por defecto.

No para secretos

No confirmes claves de API. Usa OAuth donde sea compatible o pasa las claves de API a través de la configuración segura de entorno/encabezados de tu cliente MCP.

Paquete npm

npmjs.com/package/@thinairtelematics/geo

Publicado anteriormente como thinair-geo (ahora obsoleto en favor del paquete con ámbito).