ThinAir Geo

MCP server for geocoding, reverse geocoding, truck routing with hazmat and dimension constraints, live traffic, weather, isochrones, and place search.

GitHub

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. 10 tools via MCP.

npm version License: MIT smithery badge

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

Tools

ToolDescription
geocodeConvert addresses, place names, or intersections to coordinates
reverse_geocodeConvert coordinates to addresses
batch_geocodeGeocode up to 50 addresses in one call (returns geojson FeatureCollection)
directionsTurn-by-turn routing — auto, truck, bicycle, pedestrian, motorcycle
isochroneTravel-time / -distance reachability polygons (multi-band)
trafficReal-time traffic conditions
weatherCurrent conditions and forecasts
search_placesFind nearby POIs by category (gas, charging, food, lodging, …)
exploreBrowse cities, neighborhoods, and venues by region
quotaInspect your current plan, daily usage, and remaining capacity (free, never debits)

Plus an issue_api_key utility — exposed via MCP for the API-key issuance flow but not part of the customer-facing 10-tool surface. Most clients complete OAuth at first use and never call it directly.

Truck Vehicle Profiles

Pass any of these as vehicle_profile on directions or isochrone to set dimensions automatically:

ProfileDimensions / Use case
DRY_VAN_5353′ dry van — standard US freight (default)
FLATBED_4848′ flatbed, loaded height 14′
FLATBED_4040′ flatbed, regional / specialty
STEP_DECKStep-deck / drop-deck, 11′3″ upper-deck clearance
TANKERLiquid/gas tanker (pair with hazmat=true)
BOX_TRUCK_2626′ box truck, local delivery
AUTO_CARRIERCar hauler / auto transport
SPRINTER_VANCargo van, last-mile (9′ tall)
DOUBLE_TRAILERTwin 28′ pups, LTL long-haul (92′ total)
OVERSIZEPermitted oversize loads — override dimensions per haul

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.

npm Package

npmjs.com/package/@thinairtelematics/geo

Previously published as thinair-geo (now deprecated in favor of the scoped package).

License

MIT © ThinAir Telematics

Serveurs connexes