ThinAirTelematics/thinair-geo

**Give your AI agent complete geospatial awareness** — geocode addresses and intersections, route across multiple modes (auto, truck, bicycle, pedestrian), check live traffic and weather, draw reachability polygons, and search places. Confidence-scored results so your agent knows when to ask again. 19 tools via MCP.
** 19 MCP tools** · Geocoding, routing, traffic, weather, places · Built for fleet-grade workflows
Part of ThinAir
ThinAir Geo is the geospatial intelligence layer behind ThinAir fleet workflows: geocoding, routing context, address search, service-area visibility, map intelligence, traffic, weather, and reachability.
Hosted product vs this repository
- geo.thinair.co is the hosted ThinAir product.
- This repository is the thin public MCP package/pointer for developers and AI-agent clients.
- Production use may require a ThinAir account, API key, OAuth connection, or hosted workspace.
What It Does
ThinAir Geo is a Model Context Protocol (MCP) server that gives AI agents full-stack geospatial tooling — no API integration required. Coordinates you can actually route from: intersection-level precision with confidence scores, no silent fallbacks (returns an empty result instead of a city-centroid guess when uncertain).
- **Geocoding** — Forward, reverse, intersection, and batch (50/call). Results include confidence and method so agents can branch on quality.
- **Routing** — Multi-profile: auto, truck, bicycle, pedestrian, motorcycle. 10 truck-specific presets (dry van, flatbed, step-deck, tanker, box truck, auto-carrier, sprinter, double trailer, oversize) with hazmat / dimensions / weight / time-distance constraints native.
- **Traffic** — Real-time conditions for 30+ US metros.
- **Weather** — Current conditions and forecasts.
- **Place Search & Explore** — Nearby POIs, locality discovery with population filtering.
- **Isochrones** — Drive-time / walk-time reachability polygons (multiple bands per call).
Product Links
- **Product:** https://geo.thinair.co
- **Connect / get key:** https://geo.thinair.co/connect
- **Docs:** https://geo.thinair.co/docs/getting-started
- **Pricing:** https://geo.thinair.co/checkout
- **ThinAir:** https://thinair.co
Agent Discovery
Autonomous agents and directory crawlers can discover this server's capabilities
without parsing this README. All three surfaces are live and served by the hosted
product:
| Surface | URL | Carries |
|---------|-----|---------|
| Agent card (A2A) | https://geo.thinair.co/.well-known/agent-card.json | Protocol version, endpoint, transport, auth schemes, and all 19 skills |
| Skills index | https://geo.thinair.co/.well-known/skills.json | Machine-readable catalog of the 19 tools |
| LLM guide | https://geo.thinair.co/llms.txt | Plain-text orientation for language models |
The MCP endpoint itself is https://geo.thinair.co/mcp (streamable-http; OAuth 2.1
keyless, or Authorization: Bearer).
Tools
| Tool | Description |
|------|-------------|
| geocode | Convert addresses, place names, or intersections to coordinates |
| reverse_geocode | Convert coordinates to addresses |
| batch_geocode | Geocode up to 50 addresses in one call (returns geojson FeatureCollection) |
| directions | Turn-by-turn routing — auto, truck, bicycle, pedestrian, motorcycle |