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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
sizenumberNumber of candidates to return (default 5)
querystringAddress, place name, street, intersection (e.g. 'Broadway and 42nd Street New York'), or free-form location text
layersstringRestrict to: address, street, venue, locality. Use layers=street when user clearly wants a street entity
focus_latnumberBias results near this latitude — use when user says 'near me' or 'close to'
focus_lonnumberBias results near this longitude
boundary_countrystringISO country code to reduce ambiguity
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
lonnumberLongitude
sizenumberNumber of nearby candidates (default 3)
layersstringRestrict to: address, street, venue, locality
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
tostringDestination address or 'lat,lon'
viaarrayIntermediate stops in order
fromstringOrigin address or 'lat,lon'
unitsstringDistance units (default: miles)one of
miles · kilometershazmatbooleanSet true when transporting hazardous materials to avoid restricted routes
costingstringTransport mode (default: auto). Use 'truck' for commercial vehiclesone of
auto · truck · bicycle · pedestrian · motorcycleaxle_loadnumberAxle weight in metric tons (e.g. 9.07t = 20,000 lbs per axle)
top_speednumberMaximum speed in km/h (default 105 for trucks)
use_ferrynumberFerry preference 0-1 (0=avoid, 1=allow)
axle_countnumberNumber of axles (default 5 for semi-trailer)
avoid_tollsbooleanAvoid toll roads when user requests toll-free routing
truck_widthnumberTruck width in meters (e.g. 2.6m = 8'6")
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
use_highwaysnumberHighway preference 0-1 (0=avoid, 1=prefer)
include_trafficbooleanInclude live traffic conditions along route (default: true)
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.
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
latnumberLatitude
lonnumberLongitude
unitsstringTemperature/wind units (default: imperial)one of
imperial · metriclocationstringPlace name or address (will be geocoded)
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
isochroneGenerate 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
costingstringTransport modeone of
auto · truck · bicycle · pedestrian · motorcyclelocationstringCenter point address or 'lat,lon'
contours_kmarrayDistance bands in km
truck_heightnumberTruck height in meters
truck_weightnumberTruck weight in metric tons
contours_minutesarrayTime bands in minutes, e.g. [10, 20, 30]
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
limitnumberMax results (default 10, max 50)
querystringFree-text place query such as 'truck stop', 'restaurant', 'charging station'
centerobjectCenter point for nearby search
layersstringRestrict to: venue, address
radius_mnumberSearch radius in meters (default 1000)
categoriesarrayStructured categories: food, education, health, entertainment, retail, accommodation, nightlife, transport, government, recreation
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
latnumberLatitude of center point
lonnumberLongitude of center point
sizenumberMax results (default 10, max 50)
sortstringSort mode (default: combined)one of
population · distance · combinedlayersstringComma-separated: venue, address, street, locality, neighbourhood (default: locality)
radiusstringSearch radius with unit, e.g. '50km', '30mi' (default: 150km)
locationstringCenter point address or 'lat,lon'
min_populationnumberMinimum population filter for locality results
boundary_countrystringISO country code to restrict results
quotaCheck 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 673+ live data sources.
Tools
| Tool | Description |
|---|---|
geocode | Convert an address or place name to coordinates. Returns latitude, longitude, and formatted address. Use when you need map positions or spatial analysis. |
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 | Get timezone and current local time for coordinates or city name. Returns timezone name, UTC offset, and current time. Use for scheduling across time zones. |
get_sunrise_sunset | Get sunrise/sunset times for a location by coordinates or city name. Returns exact times, daylight duration, and twilight times. Use for activity planning or astronomical data. |
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"geo": {
"url": "https://gateway.pipeworx.io/geo/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 673+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Geo data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →