How do I install @thinairtelematics/geo?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @thinairtelematics/geo need an API key?

No required environment variable is listed on this record.

What transport does @thinairtelematics/geo use?

@thinairtelematics/geo runs locally over stdio.

When was @thinairtelematics/geo last checked?

Last checked 2026-11-11. Connect your AI to geocoding, routing, traffic, weather, and place search — 19 tools via MCP.

@thinairtelematics/geo MCP sunucusu

Power your agent

Bu sunucuyu ekle

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code PlugMCP’de çalıştır

Host a copy with our keys and logs.

Local command

npx -y @thinairtelematics/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add thinairtelematics-geo -- npx -y @thinairtelematics/geo@2.2.4

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "thinairtelematics-geo": {4      "command": "npx",5      "args": [6        "-y",7        "@thinairtelematics/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

PlugMCP’de çalıştır

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Başlat

Server facts

Local

Transport: stdio
Version: 2.2.4
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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.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
`isochrone`	Travel-time / -distance reachability polygons (multi-band)
`traffic`	Real-time traffic conditions
`weather`	Current conditions and forecasts
`search_places`	Find nearby POIs by category (gas, charging, food, lodging, …)
`explore`	Browse cities, neighborhoods, and venues by region
`geocode_structured`	Geocode from discrete address components (form / CRM fields) instead of free text
`resolve_intersection`	Resolve a named cross-street (street1 × street2) to a coordinate with a confidence score
`distance_matrix`	Road distances + travel times for every origin → destination pair (≤ 625 pairs)
`locate`	Snap a coordinate to the road network — road name, class, speed limit, legality, timezone, point elevation
`map_match`	Snap a raw GPS trace (2–100 points) to the road-accurate route actually driven
`trace_attributes`	Per-segment road attributes (names, classes, speed limits, surfaces) along a matched trace
`geofence_contains`	Point-in-polygon test against a GeoJSON polygon (one boolean per point)
`place_get`	Look up a place by its stable ThinAir id (`ta_place_…` / `ta_intersection_…`)
`quota`	Inspect your current plan, daily usage, and remaining capacity (free, never debits)

Truck Vehicle Profiles

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

Profile	Dimensions / Use case
`DRY_VAN_53`	53′ dry van — standard US freight (default)
`FLATBED_48`	48′ flatbed, loaded height 14′
`FLATBED_40`	40′ flatbed, regional / specialty
`STEP_DECK`	Step-deck / drop-deck, 11′3″ upper-deck clearance
`TANKER`	Liquid/gas tanker (pair with `hazmat=true`)
`BOX_TRUCK_26`	26′ box truck, local delivery
`AUTO_CARRIER`	Car hauler / auto transport
`SPRINTER_VAN`	Cargo van, last-mile (9′ tall)
`DOUBLE_TRAILER`	Twin 28′ pups, LTL long-haul (92′ total)
`OVERSIZE`	Permitted 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.

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).

@thinairtelematics/geo

Bu sunucuyu ekle

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install @thinairtelematics/geo?

Does @thinairtelematics/geo need an API key?

What transport does @thinairtelematics/geo use?

When was @thinairtelematics/geo last checked?

Documentation

ThinAir Geo MCP Server

Part of ThinAir

Hosted product vs this repository

What It Does

Product Links

Agent Discovery

Tools

Truck Vehicle Profiles

Quick Start

Claude Desktop, Cursor, Windsurf — OAuth (recommended, keyless)

API key (for non-OAuth clients)

npx (CLI / scripts)

Not for secrets

npm Package

License