ThinAir Geo

Servidor MCP para geocodificação, geocodificação reversa, roteamento de caminhões com restrições de materiais perigosos e dimensões, tráfego ao vivo, clima, isócronas e busca de locais.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP ThinAir Geo

Dê ao seu agente de IA consciência geoespacial completa — geocodifique endereços e cruzamentos, trace rotas em vários modos (carro, caminhão, bicicleta, pedestre), consulte trânsito e clima em tempo real, desenhe polígonos de acessibilidade e pesquise lugares. Resultados com pontuação de confiança para que seu agente saiba quando perguntar novamente. 19 ferramentas via MCP.

19 ferramentas MCP · Geocodificação, rotas, trânsito, clima, lugares · Feito para fluxos de trabalho de nível frota

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

Parte do ThinAir

O ThinAir Geo é a camada de inteligência geoespacial por trás dos fluxos de trabalho de frota do ThinAir: geocodificação, contexto de rotas, busca de endereços, visibilidade de área de serviço, inteligência de mapas, trânsito, clima e acessibilidade.

Produto hospedado vs. este repositório

geo.thinair.co é o produto hospedado do ThinAir.
Este repositório é o pacote MCP público/enxuto e ponte para desenvolvedores e clientes de agentes de IA.
O uso em produção pode exigir uma conta ThinAir, chave de API, conexão OAuth ou workspace hospedado.

O que ele faz

O ThinAir Geo é um servidor Model Context Protocol (MCP) que dá aos agentes de IA ferramentas geoespaciais completas — sem necessidade de integração de API. Coordenadas a partir das quais você pode realmente traçar rotas: precisão em nível de cruzamento com pontuações de confiança, sem fallbacks silenciosos (retorna um resultado vazio em vez de um palpite de centroide de cidade quando houver incerteza).

Geocodificação — Direta, reversa, de cruzamentos e em lote (50/por chamada). Os resultados incluem confidence e method para que os agentes possam ramificar com base na qualidade.
Rotas — Multiperfil: carro, caminhão, bicicleta, pedestre, motocicleta. 10 predefinições específicas para caminhões (baú seco, plataforma, rebaixado, tanque, caminhão de caçamba, transportador de veículos, sprinter, reboque duplo, superdimensionado) com restrições nativas de materiais perigosos / dimensões / peso / tempo-distância.
Trânsito — Condições em tempo real para mais de 30 metrópoles dos EUA.
Clima — Condições atuais e previsões.
Busca e exploração de lugares — POIs próximos, descoberta de localidades com filtro por população.
Isócronas — Polígonos de acessibilidade por tempo de viagem / caminhada (várias faixas por chamada).

Links do produto

Produto: https://geo.thinair.co
Conectar / obter chave: https://geo.thinair.co/connect
Documentação: https://geo.thinair.co/docs/getting-started
Preços: https://geo.thinair.co/checkout
ThinAir: https://thinair.co

Descoberta por agentes

Agentes autônomos e rastreadores de diretórios podem descobrir as capacidades deste servidor sem analisar este README. As três superfícies estão ativas e são servidas pelo produto hospedado:

Superfície	URL	Contém
Cartão do agente (A2A)	`https://geo.thinair.co/.well-known/agent-card.json`	Versão do protocolo, endpoint, transporte, esquemas de autenticação e todas as 19 habilidades
Índice de habilidades	`https://geo.thinair.co/.well-known/skills.json`	Catálogo legível por máquina das 19 ferramentas
Guia para LLM	`https://geo.thinair.co/llms.txt`	Orientação em texto simples para modelos de linguagem

O endpoint MCP em si é https://geo.thinair.co/mcp (streamable-http; OAuth 2.1 sem chave, ou Authorization: Bearer).

Ferramentas

Ferramenta	Descrição
`geocode`	Converte endereços, nomes de lugares ou cruzamentos em coordenadas
`reverse_geocode`	Converte coordenadas em endereços
`batch_geocode`	Geocodifica até 50 endereços em uma única chamada (retorna `geojson` FeatureCollection)
`directions`	Rotas passo a passo — carro, caminhão, bicicleta, pedestre, motocicleta
`isochrone`	Polígonos de acessibilidade por tempo / distância de viagem (multifaixa)
`traffic`	Condições de trânsito em tempo real
`weather`	Condições atuais e previsões
`search_places`	Encontra POIs próximos por categoria (combustível, carregamento, alimentação, hospedagem, …)
`explore`	Navega por cidades, bairros e locais por região
`geocode_structured`	Geocodifica a partir de componentes de endereço discretos (campos de formulário / CRM) em vez de texto livre
`resolve_intersection`	Resolve uma rua transversal nomeada (rua1 × rua2) para uma coordenada com pontuação de confiança
`distance_matrix`	Distâncias rodoviárias + tempos de viagem para cada par origem → destino (≤ 625 pares)
`locate`	Ajusta uma coordenada à rede rodoviária — nome da via, classe, limite de velocidade, legalidade, fuso horário, elevação do ponto
`map_match`	Ajusta um rastro bruto de GPS (2–100 pontos) à rota precisa na via realmente percorrida
`trace_attributes`	Atributos rodoviários por segmento (nomes, classes, limites de velocidade, superfícies) ao longo de um rastro correspondido
`geofence_contains`	Teste de ponto em polígono contra um polígono GeoJSON (um booleano por ponto)
`place_get`	Consulta um lugar pelo seu id estável do ThinAir (`ta_place_…` / `ta_intersection_…`)
`quota`	Inspeciona seu plano atual, uso diário e capacidade restante (gratuito, nunca debita)
`issue_api_key`	Gera uma nova chave de API para o tenant atual (conta como 1 consulta)

Perfis de veículos para caminhões

Passe qualquer um destes como vehicle_profile em directions ou isochrone para definir as dimensões automaticamente:

Perfil	Dimensões / Caso de uso
`DRY_VAN_53`	Baú seco de 53′ — frete padrão nos EUA (padrão)
`FLATBED_48`	Plataforma de 48′, altura de carga 14′
`FLATBED_40`	Plataforma de 40′, regional / especial
`STEP_DECK`	Rebaixado / plataforma escalonada, vão livre de 11′3″ no deck superior
`TANKER`	Tanque de líquido/gás (combine com `hazmat=true`)
`BOX_TRUCK_26`	Caminhão de caçamba de 26′, entrega local
`AUTO_CARRIER`	Transportador de veículos / transporte de automóveis
`SPRINTER_VAN`	Van de carga, última milha (9′ de altura)
`DOUBLE_TRAILER`	Dois reboques de 28′, LTL de longa distância (92′ no total)
`OVERSIZE`	Cargas superdimensionadas permitidas — dimensões substituíveis por viagem

Parâmetros individuais (truck_height, truck_weight, truck_length, axle_count, etc.) substituem a predefinição.

Início rápido

Claude Desktop, Cursor, Windsurf — OAuth (recomendado, sem chave)

Adicione à configuração MCP do seu cliente (ex.: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

O fluxo OAuth é concluído no primeiro uso — sem necessidade de configuração manual de token. Nível gratuito: 15 solicitações/dia, sem cartão.

Chave de API (para clientes sem OAuth)

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

Obtenha uma chave em https://geo.thinair.co/connect.

npx (CLI / scripts)

npx -y @thinairtelematics/geo

Imprime um bloco de configuração na saída padrão para o seu cliente. A mesma opção sem chave via OAuth por padrão, como acima.

Não para segredos

Não faça commit de chaves de API. Use OAuth onde houver suporte ou passe chaves de API pela configuração segura de ambiente/cabeçalho do seu cliente MCP.

Pacote npm

npmjs.com/package/@thinairtelematics/geo

Publicado anteriormente como thinair-geo (agora descontinuado em favor do pacote com escopo).