ThinAir Geo MCP Server
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
> geocode "Bayport Terminal"
✓ matched: Bayport Terminal, Harris County, TX, USA
✓ confidence: 1.0 (method: search_venue)
✓ coordinates: 29.61345, -95.00292
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.cois 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
confidenceandmethodso 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:
The MCP endpoint itself is https://geo.thinair.co/mcp (streamable-http; OAuth 2.1
keyless, or Authorization: Bearer).
Tools
Truck Vehicle Profiles
Pass any of these as vehicle_profile on directions or isochrone to set dimensions automatically:
Individual params (truck_height, truck_weight, truck_length, axle_count, etc.) override the preset.
Quick Start
Claude Desktop, Cursor, Windsurf — OAuth (recommended, keyless)
Add to your client's MCP config (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"thinair-geo": {
"url": "https://geo.thinair.co/mcp"
}
}
}
The OAuth flow completes at first use — no manual token setup required. Free tier: 15 requests/day, no card.
API key (for non-OAuth clients)
{
"mcpServers": {
"thinair-geo": {
"url": "https://geo.thinair.co/mcp",
"headers": {
"Authorization": "Bearer ta_live_..."
}
}
}
}
Get a key at https://geo.thinair.co/connect.
npx (CLI / scripts)
npx -y @thinairtelematics/geo
Prints a config block to stdout for your client. Same OAuth-keyless option as above by default.
Not for secrets
Do not commit API keys. Use OAuth where supported or pass API keys through your MCP client's secure environment/header configuration.
npm Package
npmjs.com/package/@thinairtelematics/geo
Previously published as
thinair-geo(now deprecated in favor of the scoped package).
License
MIT © ThinAir Telematics
