@agentutility/mcp-locale

@agentutility/mcp-locale

Geo, weather, civic, identity primitives.

Geocoding, weather, timezone, holidays, flight status, building permits, property tax, VIN decode — the local-context layer for any agent that touches a place or a person.

Pricing: pay-per-call in USDC on Base. No subscriptions, no API keys. See per-tool prices below.

Install — Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agentutility-locale": {
      "command": "npx",
      "args": ["-y", "@agentutility/mcp-locale"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HEX" }
    }
  }
}

Restart Claude Desktop. 40 tools appear in the tool palette.

Install — Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "agentutility-locale": {
      "command": "npx",
      "args": ["-y", "@agentutility/mcp-locale"],
      "env": { "X402_PRIVATE_KEY": "0x..." }
    }
  }
}

Funding

Send any amount of USDC on Base mainnet to the address derived from your X402_PRIVATE_KEY. The MCP server uses it to pay for tool calls automatically.

USDC on Base contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Tools (40)

Tool	Description
address-geocode	(0.02 USDC/call) Converts a free-form address, postal code, place name, or POI into latitude/longitude. Returns a ranked list of matches with importance scores, a structured address breakdown (house number, road, city, county, state, postcode, country), and a bounding box. Backed by OSM Nominatim — global coverage, attribution required by ODbL. Use it as a forward geocoder, address to lat-lng converter, address-to-coordinates lookup, postal-code lookup, place-name resolver, Nominatim geocoder, or OpenStreetMap geocoding API.
air-quality	(0.005 USDC/call) Returns current air quality readings and AQI category for any latitude/longitude, with optional hourly forecast rows for the next 1-72 hours. Air-quality data from Open-Meteo. Use it as an air quality API covering US AQI, European AQI, PM2.5, PM10, ozone, nitrogen dioxide, sulphur dioxide, and carbon monoxide.
airport-code-lookup	(0.005 USDC/call) Resolves airport codes to airport name, municipality, country, region, coordinates, elevation, scheduled-service flag, homepage, and Wikipedia link. Same OurAirports-backed handler as iata-airport-info. Use it as an airport code lookup API for IATA airport info or ICAO airport metadata.
airport-delays	(0.02 USDC/call) Reports live US airport delays, ground stops, and closures from the FAA National Airspace System Status feed. Covers ground stops, ground delay programs (GDPs), AFPs, arrival/departure delays, and closures with reason and timing, filterable by IATA-3 airport and event type. Federal public data — no auth, no rate-limit hassle. Use it as an FAA airport delays feed, arrival-departure delay feed, NAS Status source, FAA OIS air-traffic disruption monitor, or weather-driven program-change tracker.
astro-times	(0.005 USDC/call) Sunrise sunset times. Computes sunrise, sunset, solar noon, day length (seconds), and civil / nautical / astronomical twilight begin & end for any latitude/longitude on any date. Also covers golden hour, dawn / dusk, and full astronomy-times. UTC ISO8601 strings. Wraps sunrise-sunset.org's public API — no auth, commercial-OK.
bin-lookup	(0.02 USDC/call) Looks up a credit card BIN: the first 6-8 digits resolve to issuer, country, brand, and card type via binlist.net. Useful for fraud screening, payment routing, and geo-risk. Use it as a bin lookup or IIN lookup.
bin-lookup-api	(0.02 USDC/call) Looks up card BINs, resolving the first 6-8 card digits to scheme, issuer, country, card type, prepaid/debit/credit signal, and payment-routing metadata. Same BIN/IIN backend as iin-lookup. Use it as a BIN lookup API, card BIN checker, or IIN issuer lookup.
building-permits	(0.03 USDC/call) Searches building permits across six US cities for real-estate due diligence: NYC (DOB), San Francisco, Chicago, Los Angeles, Seattle, and Austin. Each city's open-data Socrata feed is normalized to a common permit shape (permit_id, type, status, description, address, zip, filed/issued/expiration dates, applicant, work category), with filters for address substring, permit status, permit type, and recency window. A real-estate, construction, and code-compliance primitive. Use it as a construction permit search, DOB permit fetch, city open-data permits API, or property permit history lookup.
building-permits-api	(0.03 USDC/call) Searches city building permits, checking property permit history, work type, filed and issued dates, applicant, status, and address matches. Same city open-data handler as building-permits. Use it as a building permits API, construction permit lookup, or city permit search.
card-bin-lookup	(0.02 USDC/call) Resolves the first 6-8 digits of a card number to issuer bank, country, brand (Visa/Mastercard/Amex/Discover/JCB/UnionPay), and card type (debit/credit/prepaid). Use it as a credit card BIN lookup, IIN lookup, or card-issuer lookup for fraud screening, payment routing, and geo-risk.
city-weather	(0.01 USDC/call) Returns current weather by city name with an instant geocoded lookup. Same Open-Meteo geocoding plus forecast backend as weather-current-city, exposed under concise buyer wording. Use it as a city weather API or instant weather lookup.
climate-data	(0.005 USDC/call) Returns historical daily temperature, precipitation, humidity, wind, and solar radiation for any latitude/longitude. Bounded daily point data from NASA POWER for up to 366 days. Good for agriculture, energy, insurance, climate risk screening, and weather-normalized analysis. Use it as a climate data API or historical weather data source.
construction-permit-search	(0.03 USDC/call) Searches construction permits and property permit history for real-estate, construction, due-diligence, and code-compliance agents. Same multi-city permit backend as building-permits. Use it as a construction permit search API or municipal building permit lookup.
country-info	(0.005 USDC/call) Country info lookup. Resolves country metadata by common name, ISO 3166 alpha-2/alpha-3 code, or capital city. Returns capital, region, population, area, currencies, languages, timezones, calling code, flag emoji, neighbors. Wraps the public REST Countries v3.1 API — no auth, commercial-OK.
current	(0.01 USDC/call) Instant current weather by city name: geocodes a city or place name, then returns current Open-Meteo temperature, feels-like, humidity, wind, precipitation, weather code, timezone, and optional short forecast. Exact buyer-demand slug for city weather lookups. Use it as a current weather API or weather current endpoint.
current-weather	(0.002 USDC/call) Looks up current weather conditions for a latitude/longitude: temperature, humidity, precipitation, wind, and WMO condition code. Optional hourly and daily forecast included. Use it as a live weather conditions lookup.
current-weather-city	(0.01 USDC/call) Looks up current weather conditions for any named city, worldwide, without requiring latitude and longitude coordinates. Send a city name plus an optional two-letter country_code, units (metric or imperial), and forecast_days; the endpoint geocodes the place name against Open-Meteo, picks the best-scoring match (favoring capitals and larger populations when a country code is given), and returns current conditions plus an optional hourly or daily forecast. The response includes resolved_location with coordinates and timezone, alternate place matches for disambiguation, and the forecast payload. Use it as a city weather lookup API, weather-by-city-name tool, or current conditions endpoint for travel agents, dispatch tools, and location-aware assistants.
earthquakes-recent	(0.003 USDC/call) Returns recent earthquakes from USGS for any time window (hour, day, week, month) above a magnitude threshold. Each quake includes magnitude + type, depth (km), place, ISO8601 time, lat/lon, tsunami flag, USGS event URL, and felt-report count when available. Wraps USGS GeoJSON summary feeds, public domain, no auth. Use it as a recent earthquakes API or USGS earthquake feed.
flight-status	(0.01 USDC/call) Tracks live aircraft positions from the OpenSky Network. Pass icao24 (6-char hex transponder, e.g. 'a808c5'), a callsign (e.g. 'UAL124'), or a bbox {lamin,lamax,lomin,lomax}; returns last-known position, altitude, speed, heading, on-ground flag, and origin country per aircraft. Use it as a flight status check, flight tracker, ICAO24 lookup, callsign lookup, aircraft bounding-box query, or OpenSky state-vector wrapper.
geocode	(0.02 USDC/call) Geocodes addresses and place names to coordinates; exact short alias for address-geocode so agents searching for 'geocode' can discover the same global resolver. Converts a free-form address, postal code, place name, or POI into latitude/longitude, ranked matches, structured address fields, importance scores, and bounding boxes via OpenStreetMap Nominatim. Use it as a geocode API, forward geocoder, address to coordinates converter, or place name to latitude-longitude lookup.
holiday-lookup	(0.005 USDC/call) Holiday calendar. Public holidays, bank holidays, and federal holidays for any country and year. ISO 3166-1 country codes. Returns date, local name, English name, type (public/observance/regional), and scope. Wraps the public Nager.Date API — no auth, commercial-OK.
iata-airport-info	(0.005 USDC/call) Looks up airport metadata from an IATA or ICAO code. Resolves a 3-letter IATA code (SFO, JFK, LHR) or 4-letter ICAO code (KSFO, KJFK, EGLL) to airport name, type (large/medium/small/heliport/seaplane), latitude/longitude, elevation, continent, country, region, municipality, scheduled-service flag, home page URL, and Wikipedia link. Backed by the OurAirports CC0 public dataset covering ~75k airports worldwide; for live FAA delays/ground-stops see airport-delays. Use it as an IATA airport code lookup, ICAO airport lookup, airport name resolver, airport coordinates source, or airport-to-city mapper.
iin-lookup	(0.02 USDC/call) Resolves an issuer identification number (the first 6-8 card digits) to scheme, issuer, country, card type, and prepaid/debit/credit signals using binlist.net. Use it as an IIN lookup or card BIN checker.
property-tax	(0.01 USDC/call) Property tax lookup. Search a county's open-data assessor dataset by street address or parcel ID and return parcel id, owner, assessed and market value, sqft, year built, zoning, and a permalink to the source portal. Covers NYC PLUTO, SF Assessor Roll, and Cook County (Chicago) — open-data CC0 sources. Same backend as property-tax-assessment under a more search-friendly slug.
property-tax-assessment	(0.01 USDC/call) Searches county assessor records by address or parcel ID for owner, assessed value, and property details. Covers open-data assessor datasets including NYC PLUTO, SF Assessor Roll, and Cook County (Chicago); search by street address or parcel/BBL/APN identifier. Returns parcel id, owner, assessed and market value, building area (sqft), lot size, year built, zoning code, and a permalink to the source open-data portal. Open-data, CC0-licensed sources only; no proprietary commercial assessor feed. Use it as a property tax assessor lookup, parcel record search, owner-name lookup, lot-and-block lookup, or a zoning + sqft + year-built check for real-estate due diligence.
reverse-geocode	(0.02 USDC/call) Converts latitude/longitude coordinates into a structured street address. Returns house_number, road, neighborhood, suburb, city, county, state, postcode, country, and country_code, plus a human-readable display_name, place type, OSM id, and bounding box; a configurable zoom level controls address granularity (street vs. neighborhood vs. city). OSM Nominatim — global coverage, ODbL attribution required. Use it as a reverse geocoder, lat-lng to address, coords to street, GPS to postal code, what-city-is-this lookup, Nominatim reverse, or OpenStreetMap reverse-geocoding API.
satellite-address	(0.01 USDC/call) Turns a street address into a cloud-free satellite image in one call. Composes OpenStreetMap Nominatim geocoding with the Sentinel Hub Processing API: send a free-form address and get back both the geocoded address metadata and a recent cloud-free Sentinel-2 PNG centered on the best match, with an optional NASA GIBS MODIS fallback for regional views. JSON output contains: { query, geocode_result, lat, lon, zoom, bbox, data_base64, license, attribution, ... }. Use it as an address to satellite image, postal-code satellite snapshot, or place-name to space view.
satellite-bbox	(0.02 USDC/call) Builds a cloud-free Sentinel-2 mosaic over any bounding box and returns it as a single PNG composite. Sourced from the least-cloudy Sentinel-2 observation per pixel across the requested date range (mosaickingOrder=leastCC); output dimensions auto-scale to the bbox aspect ratio at native 10m resolution. Bbox area capped at 4 sq-deg per call — larger regions should be stitched from multiple calls. JSON output includes { bbox, time_range, size, data_base64, license, attribution, ... }. Use it as a bounding-box satellite composite, region satellite snapshot, or arbitrary bbox to imagery API.
satellite-change	(0.05 USDC/call) Renders before/after satellite images of the same area for change detection. Produces two cloud-free Sentinel-2 composites of the same bounding box anchored at two dates, each averaged over the window_days prior, and returns both base64 PNGs side-by-side so clients can display, animate, or pixel-diff them. Use cases: construction-site progress, vegetation change, wildfire burn scars, port/parking-lot activity, glacier retreat. Native 10m; bbox area up to 4 sq-deg. Use it as a Sentinel-2 time-series diff, construction monitoring feed, deforestation tracker, or fire-burn-scar imagery source.
satellite-tile	(0.005 USDC/call) Returns a recent cloud-free satellite image (Sentinel-2, 10m) as a PNG centered on a lat/lon at a slippy-map zoom level. Default source: CDSE Sentinel Hub Processing API with mosaickingOrder=leastCC over the prior 30 days (configurable via days_back); optional NASA GIBS MODIS Terra (~250m) source for regional zoom <=9 with zero quota. Output is JSON: { source, lat, lon, zoom, bbox, data_base64, license, attribution, ... }. License: Copernicus open data (CC BY-SA 3.0 IGO) or NASA public domain; attribution string included in every response. Use it as a satellite imagery tile, lat-lon to satellite PNG, Sentinel-2 tile API, or agent-callable cloud-free satellite snapshot.
sports-schedule	(0.01 USDC/call) Returns upcoming games and recent results for major sports leagues: MLB, NBA, NHL, NFL, WNBA, MLS, EPL, La Liga, Bundesliga, and Serie A. Pass a league code; scope='upcoming' (default) returns the next 15 events with start time, venue, and teams, while scope='recent' returns the last 15 completed games including scores. Data from TheSportsDB. Use it as a sports schedule API or TheSportsDB v1 wrapper.
sunrise-sunset	(0.005 USDC/call) Sunrise sunset times. Returns sunrise, sunset, solar noon, day length, and civil / nautical / astronomical twilight begin and end for any latitude/longitude on any date. Also covers golden-hour and dawn / dusk. Same backend as astro-times under a more search-friendly slug. UTC ISO8601 strings.
timezone-convert	(0.005 USDC/call) Converts a datetime from one IANA timezone to another with correct DST handling. ISO-8601 input: bare wall-time strings are interpreted in the from_tz, fully-qualified offsets are honored. DST is handled correctly (uses V8's built-in tzdata via Intl.DateTimeFormat). Returns both formatted strings, both UTC offsets, and the difference in hours. Use it for DST-aware time arithmetic, wall-clock to UTC conversion, or converting across cities.
timezone-lookup	(0.005 USDC/call) Timezone lookup. Returns IANA timezone, UTC offset, DST status, current local time, and DST transitions for any latitude/longitude or city name. Wraps the public TimeAPI.io endpoint — no auth, commercial-OK.
vin-decode	(0.005 USDC/call) Decodes a 17-character VIN into full vehicle details, backed by NHTSA's vPIC data (US Govt public domain). Returns make, model, model_year, manufacturer, plant country, body class, vehicle type, fuel type, engine cylinders/displacement/HP, drive type, transmission, GVWR, safety features (ABS, traction control, airbags), and any decode errors. Includes a valid_checksum flag (ISO 3779 mod-11 check; reliable for North-American VINs). Use it as a VIN decoder, VIN lookup, vehicle identification number resolver, or NHTSA vPIC wrapper.
visa-requirements	(0.005 USDC/call) Checks visa requirements between any passport and destination country. Returns whether entry is visa-free, e-visa, visa-on-arrival, or visa-required, plus permitted stay in days and a human-readable status string; pass full_matrix to get the entire 200x200 visa matrix for the passport. Backed by the public CC-BY passport-index-dataset. Use it as a passport visa lookup, visa-free travel checker, e-visa + visa-on-arrival lookup, passport-index query, travel eligibility check, or Schengen + ESTA-style entry-rules reference.
weather	(0.002 USDC/call) Current conditions and forecast for any latitude/longitude. Returns present weather plus a 1-7 day daily forecast (temp max/min, precipitation, sunrise/sunset, UV index) and an optional hourly forecast. A simple weather API on the Open-Meteo backend.
weather-api	(0.002 USDC/call) Weather API returning current conditions, hourly forecast, and a 1-7 day daily forecast for any latitude/longitude. Metric or imperial units. Open-Meteo backend. Use it as a current weather API or forecast API.
weather-current-city	(0.01 USDC/call) Returns current weather for any city or place name, no coordinates needed. Geocodes the name with Open-Meteo, chooses the best match with optional country_code, then returns current temperature, feels-like, humidity, wind, precipitation, WMO weather code, timezone, and optional daily/hourly forecast from Open-Meteo. Use it as a city weather API or instant weather lookup by place name.
weather-forecast	(0.002 USDC/call) Returns current conditions, a 1-7 day daily forecast, and an optional hourly forecast for any latitude/longitude. Daily includes temp max/min, precipitation total + probability, sunrise/sunset, max UV index, and WMO weather code. Current includes temperature, apparent temperature, humidity %, wind speed/direction, precipitation, weather code, and is_day. Metric or imperial units. Wraps the public Open-Meteo API, no auth, commercial-OK, CC-BY 4.0. Use it as a weather forecast API, hourly forecast, current weather, temperature, or UV index and sunrise-sunset lookup.

How it works

• Agent calls a tool (e.g. address-geocode).
• MCP server POSTs to https://x402.agentutility.ai/address-geocode.
• The endpoint responds HTTP 402 with payment instructions.
• The MCP server signs an EIP-3009 USDC transfer authorization with X402_PRIVATE_KEY and retries.
• CDP facilitator settles on Base.
• The endpoint returns the actual response.

The agent never sees the payment flow — it just gets the result.

Links

• Cluster overview: https://agentutility.ai/locale/
• All MCP packages: https://mcp.agentutility.ai/
• Source: https://github.com/rooz21/x402/tree/main/packages/mcp-locale

Version: 0.8.10 · License: MIT