@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. 26 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 (26)

| Tool | Description | |---|---| | address-geocode | (0.02 USDC/call) Geocoder / address-to-lat-lng / location resolver. Address or place-name → coords + structured parts (road, city, state, postcode, country). Powered by OpenStreetMap Nominatim (free public). | | airport-delays | (0.02 USDC/call) FAA NAS Status — current US airport delays, ground stops, ground delay programs, weather-driven program changes. Federal public, no auth. | | astro-times | (0.002 USDC/call) sunrise-sunset / golden-hour / civil twilight / nautical dusk / day-length / solar-noon / dawn-dusk / astronomy times. Computes sunrise, sunset, solar noon, day length (seconds), and civil / nautical / astronomical twilight begin & end for any latitude/longitude on any date. UTC ISO8601 strings. Wraps sunrise-sunset.org's public API — no auth, commercial-OK. | | bin-lookup | (0.02 USDC/call) Credit card BIN / IIN lookup. First 6-8 digits identify issuing bank, country, brand (Visa/Mastercard/Amex), card type (debit/credit/prepaid). Fraud screening, payment routing, geo-risk. Powered by binlist.net. | | building-permits | (0.03 USDC/call) Building permits multi-city open-data lookup. NYC, SF, Chicago, LA, Seattle, Austin. Filter by address substring, status, type, recency. Each city normalized to common shape (id, type, status, description, address, dates, cost). Real-estate / construction primitive. | | card-bin-lookup | (0.02 USDC/call) Credit card BIN lookup / IIN lookup / card-issuer lookup. First 6-8 digits to issuer bank, country, brand (Visa/Mastercard/Amex/Discover/JCB/UnionPay), card type (debit/credit/prepaid). Use for fraud screening, payment routing, geo-risk. | | country-info | (0.002 USDC/call) Country info / ISO 3166 / country code lookup / capital city lookup / currencies by country / population / region resolver. Resolves country metadata by common name, ISO 3166 alpha-2/alpha-3 code, or capital city, returning name, codes, capital, region, subregion, population, area (km²), currencies, languages, timezones, flag emoji, neighboring-country codes, and international calling code. Wraps the public REST Countries v3.1 API — no auth, commercial-OK. | | earthquakes-recent | (0.002 USDC/call) Earthquake feed / seismic activity / USGS / recent quakes / quake monitor / tremor data / fault line activity / tsunami alerts. Returns recent earthquakes from the past hour / day / week / month, filtered by minimum magnitude and an optional bounding box. 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. | | flight-status | (0.01 USDC/call) Flight status / live aircraft position / flight tracker / ICAO24 lookup / callsign lookup / aircraft bounding-box / OpenSky Network state-vector wrapper. 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. Single hit to OpenSky's anonymous tier (no API key, commercial-OK with attribution; shared 400 req/day pool). | | holiday-lookup | (0.002 USDC/call) Public holidays / bank holidays / national holidays / federal holidays / holiday calendar / per-country dates. Returns the official public holidays for any ISO 3166-1 alpha-2 country and year, with localized names, English names, type (Public, Bank, School, etc.), regional vs. national flag, and county/region scoping where applicable. Wraps the public Nager.Date API — no auth, commercial-OK. | | iata-airport-info | (0.005 USDC/call) IATA / ICAO airport code lookup. Returns name, type, location, country, region, municipality, scheduled-service flag, home/wikipedia links. OurAirports CC0. | | 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) Property tax assessor lookup (multi-county). NYC PLUTO, SF Assessor Roll, Cook County (Chicago). Returns assessed value, owner, parcel ID, sqft, year built, zoning. Open-data, CC0-licensed. | | reverse-geocode | (0.02 USDC/call) Reverse geocoder / lat-lng-to-address. Coords → structured address (road, city, state, postcode, country). Powered by OpenStreetMap Nominatim. | | satellite-address | (0.01 USDC/call) Address to satellite image / one-call address → cloud-free Sentinel-2 thumbnail / postal-code satellite snapshot / place-name to space view. Composes OpenStreetMap Nominatim geocoding with the Sentinel Hub Processing API: caller sends a free-form address and gets back both the geocoded address metadata and a recent cloud-free Sentinel-2 PNG centered on the best match. Optional NASA GIBS MODIS fallback for regional views. JSON output contains: { query, geocode_result, lat, lon, zoom, bbox, data_base64, license, attribution, ... }. | | satellite-bbox | (0.02 USDC/call) Bounding-box satellite composite / Sentinel-2 cloud-free mosaic / region satellite snapshot / arbitrary bbox to imagery. Returns a single PNG composite over an arbitrary lat/lon bounding box, sourced from the least-cloudy Sentinel-2 observation per pixel across the requested date range (mosaickingOrder=leastCC). Output dimensions auto-scale to bbox aspect ratio. 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, ... }. | | satellite-change | (0.05 USDC/call) Satellite before/after / change detection / Sentinel-2 time-series diff / construction monitoring / deforestation tracker / fire-burn-scar imagery. Renders two cloud-free Sentinel-2 composites of the same bounding box anchored at two dates, each averaged over the window_days prior. 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 ≤ 4 sq-deg. | | satellite-tile | (0.005 USDC/call) Satellite imagery tile / lat-lon to satellite PNG / Sentinel-2 tile API / cloud-free satellite snapshot / agent-callable satellite imagery. Returns a recent cloud-free Sentinel-2 (10m) 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. | | sports-schedule | (0.01 USDC/call) Sports schedule / MLB / NBA / NHL / NFL / WNBA / MLS / EPL / La Liga / Bundesliga / Serie A — next games + recent results / sports schedule API / TheSportsDB v1 wrapper. Pass a league code; scope='upcoming' (default) returns the next 15 events with start time, venue, teams. scope='recent' returns last 15 completed games including scores. Single hit to TheSportsDB free tier (no API key, commercial-OK with attribution). | | sunrise-sunset | (0.002 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.001 USDC/call) Timezone convert / IANA tz conversion / DST-aware time arithmetic / wall-clock to UTC / convert across cities. Convert a datetime from one IANA timezone to another. 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. | | timezone-lookup | (0.001 USDC/call) Timezone lookup / IANA tz / UTC offset / DST status / local time at lat-lng / which timezone. Resolves the current local time, IANA timezone name, UTC offset (seconds), and DST status either by IANA timezone string (e.g. 'America/Los_Angeles') or by latitude/longitude coordinates. Wraps the public TimeAPI.io endpoint — no auth, commercial-OK. | | vin-decode | (0.005 USDC/call) VIN decoder / VIN lookup / decode VIN / vehicle identification number / NHTSA vPIC wrapper. Pass a 17-char VIN; 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). Backed by NHTSA's free public vPIC API — US Govt public domain, no API key required. | | visa-requirements | (0.005 USDC/call) Visa requirements lookup. Passport country + destination → visa-free / e-visa / visa-on-arrival / visa-required + duration. Public CC-BY dataset. | | weather | (0.005 USDC/call) Weather API / weather forecast / current weather / hourly forecast. Returns current conditions plus 1-7 day daily forecast and optional hourly forecast for any latitude/longitude. Daily includes temp max/min, precipitation, sunrise/sunset, UV index. Open-Meteo backend. | | weather-forecast | (0.005 USDC/call) Weather forecast / hourly forecast / current weather / temperature / precipitation / UV index / sunrise-sunset / Open-Meteo / weather API. 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. |

How it works

1. Agent calls a tool (e.g. address-geocode).
2. MCP server POSTs to https://x402.agentutility.ai/address-geocode.
3. The endpoint responds HTTP 402 with payment instructions.
4. The MCP server signs an EIP-3009 USDC transfer authorization with X402_PRIVATE_KEY and retries.
5. CDP facilitator settles on Base.
6. 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.1.8 · License: MIT