Alaska Geoportal MCP

A statewide Model Context Protocol server over the State of Alaska Geoportal -- the Alaska Geospatial Office's ArcGIS Online organization (soa-dnr), which publishes several hundred public Feature Services from DNR (land status, statewide parcels, forestry, state parks, oil & gas, DGGS geology) and hosts the catalog that other state agencies and boroughs share into.

Ask a connected model "how many miles of forestry road are in the Mat-Su Borough", "which fire service area is this point in", or "list the CWPP areas", and it answers from the official layers: discover the layer, read its schema, query or aggregate it, and report the number with the caveats the data carries (regional coverage, Web Mercator area inflation, capped fetches).

This is a standalone fork of codeforanchorage/anchorage-gis-mcp, pointed at the state org instead of the Municipality of Anchorage, with the two MOA-only parcel tools removed and the Anchorage-specific geometry (coverage bbox, area correction) generalized to the whole state. Both are built on OpenContext.

Scope

State and Alaska-partner layers are queryable; federal ones are not. The Geoportal catalog also lists content from federal partners (Census, USGS, NOAA, USFS, BLM, FEMA ...) whose services live in federal ArcGIS tenants. Those show up in search but are refused on query, by design (see docs/SECURITY.md). Search results label each partner layer with its publishing agency; unlabelled results are the state org's. docs/ALASKA_SOURCES.md records every org and how it was verified.

Related MCP server: mcp-arcgis-tulsa

Tools (14, all read-only)

Quick start

uv sync                                   # or: pip install -r requirements.txt
cp config-alaska-geoportal.yaml config.yaml
PYTHONIOENCODING=utf-8 python scripts/local_server.py   # http://localhost:8000/mcp

# in another shell: 20 end-to-end checks against the live org
SMOKE_URL=http://localhost:8000/mcp python scripts/smoke_prod.py

Connecting

The production server is at:

https://alaska-geoportal.codeforanchorage.org/mcp

In Claude: Settings, Connectors, Add custom connector, paste the URL above. The /mcp path is required; the bare hostname (https://alaska-geoportal.codeforanchorage.org/) serves a short landing page that repeats these instructions, so a pasted URL without the path tells you what went wrong instead of failing silently.

Claude Desktop and Claude Code can also connect through stdio_bridge.py or the Go client in client/. See docs/GETTING_STARTED.md.

Deploy

AWS Lambda + API Gateway via Terraform (terraform/aws/), one Lambda per fork. ./scripts/deploy.sh -e prod packages config.yaml into the zip and plans before applying. Deployed to prod on 2026-09-15; the custom domain cutover is pending DNS. Operations notes are in docs/RUNBOOK.md.

Documentation

Contributing

uv run ruff check core/ plugins/ server/ tests/
uv run pytest tests/ -n auto

Pre-commit hooks (Ruff, yamllint, gofmt): pip install pre-commit && pre-commit install.

License and attribution

MIT -- see LICENSE.

• OpenContext (the plugin framework, core/, server/, the generic ckan / arcgis / socrata plugins, Terraform and deploy tooling): Srihari Raman, City of Boston Department of Innovation and Technology.

• Anchorage GIS MCP (the ArcGIS Portal plugin this one is derived from, the spatial tools, caveat machinery and security model) and this statewide fork: Code for Anchorage.

• Data: State of Alaska, Alaska Geospatial Office / Department of Natural Resources, via the public Alaska Geoportal. Check each layer's own terms of use in its item description.