Summary
Connects Claude to free geographic APIs through a streamable HTTP gateway. You get five tools: geocode addresses to coordinates, reverse geocode coordinates to street addresses, look up country data by name or ISO code, fetch timezone and current time for locations, and get sunrise/sunset times. Runs through Pipeworx's gateway infrastructure, which means you can either use this standalone geo endpoint or connect to their full gateway for access to 600+ other data sources. Useful when you need location lookups, timezone conversions, or coordinate transforms without managing API keys yourself.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
11 tools
geocodeConvert an address, place name, street, or intersection into coordinates and structured location results. Use when input is text and you need coordinates before routing, weather, or search. Supports street-level resolution and proximity biasing.6 params
Convert an address, place name, street, or intersection into coordinates and structured location results. Use when input is text and you need coordinates before routing, weather, or search. Supports street-level resolution and proximity biasing.
Parameters* required
boundary_countrystringISO country code to reduce ambiguity
focus_latnumberBias results near this latitude — use when user says 'near me' or 'close to'
focus_lonnumberBias results near this longitude
layersstringRestrict to: address, street, venue, locality. Use layers=street when user clearly wants a street entity
querystringAddress, place name, street, intersection (e.g. 'Broadway and 42nd Street New York'), or free-form location text
sizenumberNumber of candidates to return (default 5)
reverse_geocodeConvert coordinates into the nearest address, street, or place. Use when starting from GPS coordinates or a map position.4 params
Convert coordinates into the nearest address, street, or place. Use when starting from GPS coordinates or a map position.
Parameters* required
latnumberLatitude
layersstringRestrict to: address, street, venue, locality
lonnumberLongitude
sizenumberNumber of nearby candidates (default 3)
directionsGenerate routes, ETAs, and turn-by-turn directions between locations. Supports car / truck / motorcycle / pedestrian / bicycle, with hazmat + dimension + toll avoidance for commercial routing. ETAs are returned as ISO 8601 with timezone offset (in the destination's local timez...18 params
Generate routes, ETAs, and turn-by-turn directions between locations. Supports car / truck / motorcycle / pedestrian / bicycle, with hazmat + dimension + toll avoidance for commercial routing. ETAs are returned as ISO 8601 with timezone offset (in the destination's local timez...
Parameters* required
avoid_tollsbooleanAvoid toll roads when user requests toll-free routing
axle_countnumberNumber of axles (default 5 for semi-trailer)
axle_loadnumberAxle weight in metric tons (e.g. 9.07t = 20,000 lbs per axle)
costingstringTransport mode (default: auto). Use 'truck' for commercial vehiclesone of
auto · truck · bicycle · pedestrian · motorcyclefromstringOrigin address or 'lat,lon'
hazmatbooleanSet true when transporting hazardous materials to avoid restricted routes
include_trafficbooleanInclude live traffic conditions along route (default: true)
tostringDestination address or 'lat,lon'
top_speednumberMaximum speed in km/h (default 105 for trucks)
truck_heightnumberTruck height in meters (e.g. 4.11m = 13'6"). Triggers bridge avoidance
truck_lengthnumberTruck length in meters (e.g. 16.2m = 53')
truck_weightnumberTruck weight in metric tons (e.g. 36.3t = 80,000 lbs). Triggers weight-restricted road avoidance
truck_widthnumberTruck width in meters (e.g. 2.6m = 8'6")
unitsstringDistance units (default: miles)one of
miles · kilometersuse_ferrynumberFerry preference 0-1 (0=avoid, 1=allow)
use_highwaysnumberHighway preference 0-1 (0=avoid, 1=prefer)
vehicle_profilestringPreset vehicle: DRY_VAN_53, FLATBED_48, TANKER, BOX_TRUCK_26, SPRINTER_VAN, DOUBLE_TRAILER, OVERSIZE. Sets height/weight/length automatically. Individual params override.
viaarrayIntermediate stops in order
trafficRetrieve live traffic conditions, congestion, and speed for a location. Use when traffic is needed independently of routing — for corridor monitoring, area congestion, or incident checks. COVERAGE: live data for ~30 major US metros; returns degraded or empty values outside the...3 params
Retrieve live traffic conditions, congestion, and speed for a location. Use when traffic is needed independently of routing — for corridor monitoring, area congestion, or incident checks. COVERAGE: live data for ~30 major US metros; returns degraded or empty values outside the...
Parameters* required
latnumberLatitude
lonnumberLongitude
unitsstringSpeed units — auto-detected from location (mph in US/UK, km/h elsewhere). Override if needed.one of
miles · kilometersweatherGet current and forecast weather for a location, including severe weather alerts and minute-by-minute precipitation. Use for destination conditions, travel planning, or route risk assessment.8 params
Get current and forecast weather for a location, including severe weather alerts and minute-by-minute precipitation. Use for destination conditions, travel planning, or route risk assessment.
Parameters* required
forecast_daysnumberForecast days 1-16 (default 5)
include_alertsbooleanInclude severe weather alerts and warnings (default: true)
include_forecastbooleanInclude multi-day hourly forecast
include_minutelybooleanInclude minute-by-minute precipitation for next 60 min
latnumberLatitude
locationstringPlace name or address (will be geocoded)
lonnumberLongitude
unitsstringTemperature/wind units (default: imperial)one of
imperial · metricisochroneGenerate travel-time or travel-distance reachability polygons from an origin. Pass MULTIPLE bands in one call — e.g. `contours_minutes:[10,20,30]` returns three nested polygons in a single response (one round-trip, not three). Use for service coverage, dispatch range, territor...6 params
Generate travel-time or travel-distance reachability polygons from an origin. Pass MULTIPLE bands in one call — e.g. `contours_minutes:[10,20,30]` returns three nested polygons in a single response (one round-trip, not three). Use for service coverage, dispatch range, territor...
Parameters* required
contours_kmarrayDistance bands in km
contours_minutesarrayTime bands in minutes, e.g. [10, 20, 30]
costingstringTransport modeone of
auto · truck · bicycle · pedestrian · motorcyclelocationstringCenter point address or 'lat,lon'
truck_heightnumberTruck height in meters
truck_weightnumberTruck weight in metric tons
search_placesCATEGORY-specific POI search near a point — gas stations, truck stops, restaurants, charging stations, etc. Use this when the user has a specific TYPE of place in mind (food / health / retail / fuel / accommodation / nightlife / transport / government / recreation). For broade...6 params
CATEGORY-specific POI search near a point — gas stations, truck stops, restaurants, charging stations, etc. Use this when the user has a specific TYPE of place in mind (food / health / retail / fuel / accommodation / nightlife / transport / government / recreation). For broade...
Parameters* required
categoriesarrayStructured categories: food, education, health, entertainment, retail, accommodation, nightlife, transport, government, recreation
centerobjectCenter point for nearby search
layersstringRestrict to: venue, address
limitnumberMax results (default 10, max 50)
querystringFree-text place query such as 'truck stop', 'restaurant', 'charging station'
radius_mnumberSearch radius in meters (default 1000)
batch_geocodeGeocode multiple addresses in one request with structured per-record results. Use for bulk operations instead of repeated single geocode calls. Max 50 per batch.1 params
Geocode multiple addresses in one request with structured per-record results. Use for bulk operations instead of repeated single geocode calls. Max 50 per batch.
Parameters* required
addressesarrayArray of addresses to geocode
exploreBROWSING / DISCOVERY search — cities, neighbourhoods, or mixed venues near a location. Use this when the user is exploring a REGION rather than looking for a specific category. Supports population filtering ('cities > 100k'), distance/population sorting, and layer filtering (l...9 params
BROWSING / DISCOVERY search — cities, neighbourhoods, or mixed venues near a location. Use this when the user is exploring a REGION rather than looking for a specific category. Supports population filtering ('cities > 100k'), distance/population sorting, and layer filtering (l...
Parameters* required
boundary_countrystringISO country code to restrict results
latnumberLatitude of center point
layersstringComma-separated: venue, address, street, locality, neighbourhood (default: locality)
locationstringCenter point address or 'lat,lon'
lonnumberLongitude of center point
min_populationnumberMinimum population filter for locality results
radiusstringSearch radius with unit, e.g. '50km', '30mi' (default: 150km)
sizenumberMax results (default 10, max 50)
sortstringSort mode (default: combined)one of
population · distance · combinedquotaCheck current usage, remaining limits, plan, and quota breakdown for the caller. FREE TO CALL — never counts against your quota, never blocked by it. Use this proactively when the user asks about usage or seems near limits.
Check current usage, remaining limits, plan, and quota breakdown for the caller. FREE TO CALL — never counts against your quota, never blocked by it. Use this proactively when the user asks about usage or seems near limits.
No parameter schema in public metadata yet.
issue_api_keyMint a fresh API key for your current authenticated user/tenant. Useful for CLI workflows, key rotation, or MCP clients that hide the configured Bearer. The new key is tied to your existing plan. Counts as 1 query against your daily quota.
Mint a fresh API key for your current authenticated user/tenant. Useful for CLI workflows, key rotation, or MCP clients that hide the configured Bearer. The new key is tied to your existing plan. Counts as 1 query against your daily quota.
No parameter schema in public metadata yet.
mcp-geo
Geo MCP — geographic utilities from free public APIs
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.
Tools
| Tool | Description |
|---|---|
geocode | Convert an address or place name to up to 5 matching coordinates via OpenStreetMap Nominatim. Returns latitude, longitude, display_name, and place type for each result. |
reverse_geocode | Convert coordinates to a physical address. Returns street address, city, country, and postal code. Use to identify locations from lat/lng pairs. |
get_country | Get country information by name or ISO code (e.g., 'US', 'FR'). Returns capital, population, currency, languages, and neighboring countries. Use for regional context or facts. |
get_timezone | Look up the IANA timezone name, current local time, and UTC offset (hours) for a given latitude and longitude via TimeAPI.io. Requires coordinates — does not accept city names. |
get_sunrise_sunset | Fetch sunrise, sunset, solar noon, civil twilight begin/end, and day length (seconds) for a given latitude/longitude on an optional YYYY-MM-DD date (defaults to today) via the Sunrise-Sunset API. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"geo": {
"url": "https://gateway.pipeworx.io/geo/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/geo/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Geo data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →