io.github.uponex/gisgp

Reverse-geocode a WGS84 point to country/region/locality via OSM Nominatim (no key, free — fair-use rate limited, best-effort). Returns JSON: {ok, display_name, country, country_code, region, locality, source}.

PAID (100 credits) — nearby FAA-registered vertical obstructions (towers, stacks, wind turbines) at a US point, for telecom/tower-siting due diligence (e.g. "is there anything tall already near this proposed tower site", "does a 250ft tower here need FAA notification"). Source: official FAA Digital Obstacle File (652k+ records nationwide). If proposed_height_agl_ft is given, flags the general 14 CFR Part 77 200ft AGL notification threshold — a single well-documented rule, not a full aeronautical study (lower heights near airports can also trigger notification, not checked here). Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, obstacle_count, obstacles, tallest_nearby_agl_ft, likely_requires_faa_notification, note}.

PAID (300 credits) — data center site-scouting composite: grid proximity (power availability), multi-source hazard (seismic + FEMA + NOAA, required — same contract as assess_property_hazard), land cover, and a year of temperature history (cooling-load proxy). No invented overall suitability score — each source reported honestly. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, hazard, grid_proximity, land_cover, cooling_climate, note}.

PAID (100 credits) — US Inflation Reduction Act "energy community" bonus tax credit qualification lookup for a renewable energy project site. Checks both DOE/NETL-published qualifying pathways (coal-mine- closure/coal-plant-retirement adjoining tracts, and MSA/non-MSA fossil- fuel-employment + above-average-unemployment areas) — a point qualifies if either matches. Reports qualification only, not a project-specific dollar estimate (the +10 percentage-point ITC/PTC bonus is the one publicly documented figure). Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, lon, lat, qualifies_ for_bonus_credit, coal_closure_pathway, msa_fossil_employment_pathway, bonus_note, source}.

One-call EV charging site-scouting indicator: grid proximity (power for fast-charging) + land cover + locality context, combined from GISGP's existing free primitives. No key needed. Returns JSON: {ok, grid_proximity, land_cover, location, physically_unsuitable}.

Electric grid infrastructure proximity at a US point: nearby substations + transmission lines within 10 miles (community ArcGIS mirror of HIFLD data — proximity indicator, not a certified survey). No key needed. Returns JSON: {ok, substations: {count, nearest, source}, transmission_lines: {count, volt_classes, owners, source}}.

Natural gas interstate/intrastate transmission pipeline proximity at a US point (EIA/HIFLD, 32,892 segments). Substitute for proprietary local-utility "call before you dig" data — covers major transmission pipelines only, NOT local distribution lines. Not a substitute for calling 811 before excavation. No key needed. Returns JSON: {ok, count, pipeline_types, operators, source, note}.

PAID (200 credits PER PROPERTY, max 25 properties/call) — bulk physical climate-risk disclosure input for a real-estate/asset portfolio (SEC climate disclosure rule / EU CSRD physical-risk reporting). Runs assess_property_hazard for each [lon, lat] property and returns honest aggregate counts (properties with FEMA disaster history, properties with active NOAA alerts) alongside each property's own full result — no invented portfolio-level risk score. Use estimate_cost(tool_name= "assess_portfolio_climate_disclosure", units=<property count>) first to quote. Requires Authorization: Bearer <api_key>. Returns JSON: {ok, evaluated, scored_count, failed_count, failed, properties_with_disaster_ history_10y, properties_with_active_weather_alerts, properties, note}.

PAID (200 credits) — multi-source US property hazard indicator: USGS seismic risk (required), plus best-effort FEMA disaster declaration history (state, last 10 years) and NOAA real-time active severe weather alerts at the point. Requires Authorization: Bearer <api_key> and a sufficient credits balance — top up at https://gisgp.com/billing/mcp-credits/topup. Use estimate_cost first to quote without charging. Returns JSON: {ok, pga_percent_g, hazard_note, source, disaster_history_10y, active_weather_alerts}. NOTE 2026-07-28: still not a full multi-hazard property report — no flood-plain/wildfire-hazard polygon layer is reachable from GISGP's infrastructure (FEMA NFHL/USFS geo-IP/WAF blocks), see hazard_scoring.py module docstring and .claude/plans/kind-snacking-puppy.md. No invented composite risk score — each source is reported honestly as what it is.

PAID via x402 (USDC on Base Sepolia testnet, ~$0.20/call) — no GISGP account or API key needed, the agent pays directly on-chain. Multi-source US property hazard indicator (USGS seismic + FEMA disaster history + NOAA active alerts), same underlying data as assess_property_hazard. Returns JSON: {ok, pga_percent_g, hazard_note, source, disaster_history_10y, active_weather_alerts}.

US protected/conservation area proximity via USGS PAD-US (public domain, commercial-use OK — unlike Protected Planet/WDPA, whose API explicitly forbids commercial-entity use). Reports whether the point falls inside/near (2 mile radius) a federally-tracked protected area: name, managing agency, designation type, public access. US-only. Returns JSON: {ok, count, areas, source, note}.

PAID (100 credits) — reforestation/afforestation site-scouting composite: terrain, land cover (flags already-forested/urban/water/snow as unsuitable), and a year of precipitation history (tree-viability proxy). All-free-primitive composite, priced for the bulk-screening convenience (carbon-offset/land-screening use case), no invented "sequestration score". Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, terrain, land_cover, physically_unsuitable, precipitation, note}.

One-call solar/wind site-scouting indicator: terrain + land cover + 1-year solar/wind climate averages + grid proximity, combined from GISGP's existing free primitives (no new external source). No key needed. Returns JSON: {ok, terrain, land_cover, solar_wind, grid_proximity}. Not a substitute for a professional feasibility study.

PAID (300 credits) — master due-diligence report for a point: wraps assess_property_hazard (seismic + FEMA + NOAA, required) plus grid proximity, land cover, and reverse-geocoded locality — all in one call. No invented overall "site score" across sources. Requires Authorization: Bearer <api_key> and sufficient credits balance. Use estimate_cost first to quote. Returns JSON: {ok, hazard, grid_exposure, land_cover, locality, note}.

PAID (400 credits) — checks whether two supposedly-redundant sites (e.g. two "backup" suppliers/warehouses/data centers) are actually independent: real geodesic distance between them + each site's own multi-source hazard profile (seismic + FEMA + NOAA) side by side, plus any FEMA disaster incident types they share in the last 10 years. No invented "redundancy score" — the caller judges independence from the real data. CAVEAT: FEMA disaster history is STATE-level, not point-level — two sites in the same state usually share most incident types regardless of true distance, so distance_km is the more reliable independence signal for same-state comparisons. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, distance_km, site_a, site_b, shared_fema_incident_types_10y, note}.

One-call cell tower site-scouting indicator: grid proximity + terrain elevation (line-of-sight proxy) + land cover, combined from GISGP's existing free primitives. No key needed. Returns JSON: {ok, grid_proximity, terrain, land_cover, physically_unsuitable}.

Real-time active wildfire proximity at a point via NASA FIRMS (VIIRS satellite hotspot detections, last 2 days) + electric grid exposure (transmission lines are a documented wildfire-ignition- liability factor). No key needed — GISGP holds its own free NASA FIRMS key server-side. Two separate honest indicators, no fabricated combined risk score. Returns JSON: {ok, active_fires, grid_proximity}.

Full one-call QA report of an ArcGIS FeatureServer layer: health (latency, record count, capabilities) + field schema + coded domains + summary counts. One call replaces separate health/fields/domains lookups. Returns JSON: {name, geometry_type, health, fields, domains, summary}.

Buffer every feature by a distance in METRES (negative shrinks). Geodesically accurate at any latitude (each feature is buffered in a local equidistant projection). Returns JSON {ok, distance_m, geojson} where geojson is a FeatureCollection of buffer polygons.

PAID PER DELIVERY (30 credits each time it fires, NOT at creation — free to create/cancel) — the only MCP tool that exposes GISGP's core recurring-export product to agents: creates a schedule that re-exports a FeatureServer layer on its own and POSTs the file straight to your own webhook_url, no email/web UI account needed beyond the API key. Reuses the same scheduler that runs the paid web app's scheduled exports (fires within ~5 min of the due time). format: "csv", "geojson", "shapefile", "kml", or "excel". frequency: "hourly" (top of each hour), "daily" (at run_hour UTC), "weekly" (at run_hour UTC on `weekday`, 0=Monday..6=Sunday), or "monthly" (at run_hour UTC on `monthday`, 1-28). webhook_url: must be a public, reachable HTTPS URL (validated at creation AND at every delivery) — GISGP POSTs a JSON body {schedule_id, format, row_count, filename, delivered_at, data_base64 (or download_url for files >5MB)}. If the wallet lacks 30 credits when a delivery is due, that cycle is silently skipped (schedule stays active, no error surfaced to you) — top up any time at https://gisgp.com/billing/mcp-credits/topup and the next cycle delivers normally. Use estimate_cost or check_wallet_balance to plan ahead. Delete via cancel_export_schedule when no longer needed — an abandoned schedule with an empty wallet just skips forever, but does not charge or error. Requires Authorization: Bearer <api_key>. Returns JSON: {ok, schedule_id, next_run_at}.

PAID (150 credits) — fetch ALL records from a live FeatureServer layer (no 50-record preview cap), auto-repair invalid geometries (GEOS make_valid), and scan for common problems, in one call. Replaces an uncapped query_features call (itself a paid-only capability) plus fix_geometry plus find_layer_issues. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, feature_count, fixed_count, truncated, issues, issue_count, geojson} — geojson is the fetched (and repaired) data.

PAID (120 credits) — fetch ALL records from a live FeatureServer layer once, then export the same data as Shapefile + CSV + GeoJSON + KML + Excel in a single ZIP (base64-encoded). Replaces an uncapped fetch plus 4 separate format-conversion calls. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, feature_count, truncated, zip_base64, formats}.

PAID (30 credits PER ADDRESS, max 10 addresses/call) — batch geocode + enrich. For each address: forward-geocodes to lon/lat (free fallback chain: OSM Nominatim -> Photon -> US Census), then reverse-geocodes for country/region/locality context and classifies land cover at that point. Replaces 3 separate calls per address: geocode_address + analyze_location + classify_land_cover. Use estimate_cost(tool_name= "bundle_geocode_enrich", units=<address count>) first to quote. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, results: [{address, ok, lon, lat, display_name, geocode_source, country, region, locality, land_cover} or {address, ok:false, error}], evaluated, failed_count}.

PAID (40 credits) — one-call file migration: convert a raw file to GeoJSON, then optionally reproject and simplify, then round coordinates. Replaces 2-4 separate free tool calls (convert + reproject + simplify + round) an agent would otherwise chain by hand — see estimate_cost's "replaces" field. Requires Authorization: Bearer <api_key> and sufficient credits balance. input_format: "shapefile" (data = base64-encoded .zip), "kml", "gpx", or "csv" (data = raw text for the latter three). to_epsg: 0 skips reprojection (keeps the converter's native WGS84 output). simplify_tolerance: 0 skips simplification (Douglas-Peucker, degrees). round_decimals: coordinate rounding, always applied (default 6). Returns JSON: {ok, feature_count, geojson, reprojection_notice}.

PAID (100 credits) — migration-readiness report comparing two FeatureServer layers: schema diff, coded-value domains, and field types for both. Replaces compare_schemas + extract_domains×2 + check_field_types×2. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, schema_diff, domains_a, domains_b, fields_a, fields_b, ready, blockers} — ready is False and blockers lists the reasons if the schema diff finds added/removed/changed fields or a geometry mismatch.

Real driving distance + duration between two points. Default: OSRM (public demo instance, no key — fair-use limited, not a production SLA). Optional agol_token: route through Esri's own World Route Service instead — uses YOUR OWN AGOL credentials/quota, not GISGP's (no extra charge either way, no GISGP account needed for this option). Returns "no_route" honestly when no driving path exists (e.g. across open water). Returns JSON: {ok, routable, distance_km, duration_min, source}.

FREE — cancel a schedule created by bundle_create_export_schedule. Only the API key that created it can cancel it. Returns JSON: {ok} or {ok: false, error}.

Get the center point of each polygon/line feature — e.g. "find the center of each parcel", "convert polygons to points for labeling", "centroid of each feature". Properties are kept. Returns JSON {ok, geojson} — a FeatureCollection of points.

Inspect the field schema of an ArcGIS FeatureServer layer. Returns JSON: {layer_name, geometry_type, fields:[{name, alias, type, length, nullable, has_domain}]} — useful before importing/mapping data.

Check whether an ArcGIS FeatureServer layer is reachable and responsive. Returns JSON: {ok, ms (latency), name, geometry_type, field_count, record_count, capabilities, max_record_count}.

FREE — check your own MCP credits wallet balance (the same account paid tools like assess_property_hazard charge against). Requires Authorization: Bearer <api_key> — an agent can call this on its own, no browser/dashboard needed. Returns JSON: {ok, balance, eur_equivalent} or {ok: false, error} if no API key was provided.

Land cover class at a WGS84 point via ESA CCI Land Cover 2018 (ArcGIS Living Atlas ImageServer, no key, 300m resolution). Returns JSON: {ok, class_code, class_label, source}. NOTE 2026-07-26: gated separately (mcp_layer1_landcover, Off pending live smoke-check) — swapped from the earlier ESA WorldCover WMS source, which was confirmed dead (being phased out). This ArcGIS REST identify endpoint was live-verified locally (Sofia -> class 8, "Artificial Surface or Urban Area") before this swap.

Compare the field schemas of two ArcGIS FeatureServer layers. Returns JSON diff: {added, removed, changed:[{field, diffs}], same, geometry_match, identical} — useful for QA before an import or migration.

Convert coordinate pairs between EPSG coordinate systems (max 1000 points). points: [[x, y], ...] in from_epsg axis order (lon/lat for EPSG:4326). Returns JSON: {"points": [[x, y], ...], "from_epsg": ..., "to_epsg": ...}.

Draw the smallest polygon that wraps around all input features (a convex hull) — e.g. "draw a boundary around these points", "find the outer perimeter of my data", "convex hull of these locations". Returns JSON {ok, geojson} — a single polygon.

Count features in an ArcGIS FeatureServer layer, optionally filtered by a WHERE clause. service_url: full layer URL ending in /FeatureServer/<n>. token: only for private layers. Returns JSON: {"ok": true, "count": ..., "name": ..., "geometry": ...}.

Convert a CSV/spreadsheet with lat/lon (or X/Y) columns to GeoJSON — auto-detects the coordinate columns (e.g. "map this spreadsheet", "CSV with lat/lon to GeoJSON", "turn my Excel export into map points"). Returns a GeoJSON FeatureCollection as a JSON string.

Convert a CSV with latitude/longitude columns directly to GPX waypoints (2026-09-03) — e.g. "these coordinates to a GPX for my GPS". Column names are auto-detected (lat/latitude/y, lon/lng/longitude/x).

Detect whether [x, y] pairs are [lon, lat] or [lat, lon] — resolves a genuinely common real-world confusion (one of the most-viewed GIS StackExchange questions ever, 550k+ views). Certain when any value exceeds ±90 (only longitude can); honestly reports 'inconclusive' otherwise, never a fabricated guess. Pure computation, no external API. Returns JSON: {ok, order, confidence, note}.

Keyword search across ArcGIS Hub Open Data — real public FeatureServer/MapServer datasets from government/organization ArcGIS Online portals worldwide. Returns real service_url values usable directly with query_features/count_features/rest_explore/compare_schemas. Free, no API key. Not a universal open-data search (ArcGIS Hub coverage only — see tool note). Returns JSON: {ok, query, count, results, source, note}.

PAID (30 credits) — open-data discovery with the metadata an agent needs BEFORE querying: up to 50 ArcGIS Hub results (free tool: 10) and, for the top 25, each layer's geometry type, field list, record count and query capability — so you can pick the right layer in one call instead of probing each service_url. Same coverage as the free discover_open_geodata (ArcGIS Hub Open Data), no key, real REST metadata. Needs an API key with credits — use estimate_cost first. Returns JSON: {ok, query, count, enriched, results:[{name, type, source_org, description, service_url, layer_name, geometry_type, fields, field_count, record_count, max_record_count, supports_query}]}.

Merge overlapping/adjacent geometries into one (optionally grouped by a property field `by` → one dissolved feature per distinct value). Returns JSON {ok, by, group_count, geojson}.

Convert an AutoCAD DXF file's contents to GeoJSON — e.g. "convert this DXF to GeoJSON", "AutoCAD drawing to GIS format", "DXF export from Civil 3D to GeoJSON", "extract only the UTILITIES layer from this DXF". POINT/LINE/LWPOLYLINE/POLYLINE/ARC/CIRCLE entities convert (arcs/circles are tessellated into LineString/Polygon); splines, text, hatches and 3D solids have no GIS geometry equivalent and are skipped, not errored on. Every feature's properties.layer carries its DXF layer name (group code 8). Pass `layer` to return only that layer's entities — see list_dxf_layers to discover what layer names exist first.

PAID (150 credits) — render a DXF drawing to a one-page PDF site-plan report (vector plot + entity-type breakdown + layer list, base64- encoded PDF) — e.g. "make a PDF of this site plan", "DXF to PDF report". No basemap (DXF coordinates are usually local drawing units, not real lon/lat) — use georeference_dxf first if you need a real-world-referenced report. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, pdf_base64, feature_count}.

Ready-to-paste <iframe> embed code for a live interactive map — thin wrapper around share_map (same live page, same 30-day TTL), for embedding directly in a website/dashboard rather than sharing a link. Returns JSON: {ok, embed_html, url, expires_at}.

Get the bounding box (min/max rectangle) around each feature — e.g. "get the bounding box of this shape", "bbox for each feature", "rectangular extent of my geometry". Properties are kept. Returns JSON {ok, geojson}.

Suggest the correct UTM EPSG code to project a WGS84 lon/lat into for accurate metric measurements (buffer/area/distance). Returns JSON {ok, epsg, utm_zone, hemisphere, name, warning}.

FREE — quote a paid tool's cost WITHOUT executing it or charging the wallet (call this before assess_property_hazard etc.). `units` = candidate/item count for per-unit-priced tools (currently only rank_hazard_safe_sites — pass the number of candidates you intend to submit); ignored (treated as 1) for every flat-priced tool. Returns JSON: {ok, tool_name, units, credits, eur_estimate} for credits-wallet tools; for assess_property_hazard_x402 (paid on-chain via x402, not the credits wallet) returns {ok, tool_name, units, payment, price_usd} instead; or {ok: false, error} for an unknown/free tool name.

PAID (80 credits) — convert a GeoJSON FeatureCollection to an Excel workbook (.xlsx, base64-encoded). Point geometries get LATITUDE/LONGITUDE columns; other geometry types get a GEOMETRY_WKT column. Separate from the web app's own Excel export (AGOL-service-tied, quota-gated there). Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, xlsx_base64, feature_count}.

PAID (150 credits) — render an ad-hoc GeoJSON FeatureCollection to a one-page PDF report (static map + property table, base64-encoded PDF). Separate from the web app's own PDF Builder (AGOL-service-tied, quota- gated there) — this is for GeoJSON an agent already has in hand. Requires Authorization: Bearer <api_key> and sufficient credits balance. Returns JSON: {ok, pdf_base64, feature_count, truncated, size_bytes}.