View Source Repository
PermitAI™

NEPA MCP Toolkit

12 Federal Agencies 19 Servers 78 Research Capabilities One Protocol

Model Context Protocol servers giving AI agents direct access to public federal data for NEPA screening, regulatory research, and permitting analysis.

Get Started See Demo

Works with

One Unified Protocol

Unified access across federal permitting domains

Featured server

Map Composer in Action

Federal GIS layers composed into one screening map

Finding Review pathway

Toggle overlays in the control panel · click any feature for its attributes

11 of 32 available layers, for a Chesapeake Bay project area. See the full catalog.

Before
After
Four steps

Quick Start

Install once, then point your agent at any of the 19 servers

1

Install

Python 3.12+ and pipx. One package installs all 19 servers. 

pipx install nepa-mcp
pipx ensurepath

Reopen the terminal if ensurepath changes your PATH. Older default Python: add --python 3.12.

2

Verify

Confirm 19 servers before you wire up a client. doctor exits non-zero if one is missing. 

$ nepa-mcp doctor
nepa-mcp version: 0.1.1
Python: 3.12.12
Credential file: ~/…/nepa-mcp/credentials.env (not found)
Installed servers: 19
census credentials: optional, missing CENSUS_API_KEY
epa_aqs credentials: optional, missing EPA_AQS_EMAIL, EPA_AQS_API_KEY

The credential lines are optional, and affect only Census and EPA AQS. Run nepa-mcp list-servers for the full table.

3

Connect your client

Go to the project directory you want configured, then run its command.

4

Ask a question

Reload the client — in Codex, start a new task — then try one of these.

  • What listed species and critical habitat are near 38.98, −76.49?
  • Build a screening map for a 20-mile project area there.
  • What does 40 CFR 230.10 say, and when did it last change?
Instead of step 3

Codex Desktop plugin

One install for all 19 servers and the screening skill

Codex marketplace

The repository publishes a Codex marketplace and plugin. One install registers all 19 servers and the nepa-screening skill, which tells the agent how to establish a project area and pick the right datasets.

  • All 19 servers at once, with no per-server entries
  • Bundles the screening skill and starter prompts
  • Adds directly from GitHub, with no repository clone required

In Codex Desktop, after pipx install nepa-mcp:

  1. 1. Open Plugins and select Add plugin marketplace.
  2. 2. Enter pnnl/nepa-mcp for Source and v0.1.1 for Git ref.
  3. 3. Add the marketplace, then install NEPA-MCP.

Codex CLI alternative:

codex plugin marketplace add pnnl/nepa-mcp --ref v0.1.1
codex plugin add nepa-mcp@nepa-mcp-local

Start a new Codex task after installing or updating the plugin so the tools and skill are loaded.

MCP Servers

Nineteen specialized servers for federal environmental data

Flip any card to see what it covers

Agency names identify upstream data provenance only.

Tools Reference

Search all 46 tools and the parameters they take

Map Layers

Thirty-two overlays · pick a profile to see its membership

Every layer is reported as ok, empty, partial, or failed — an empty layer means no local features, not a missing capability.

Documentation

References maintained alongside the code

Open-source project

Contribute & Support

Development guidance, support boundaries, and community standards are maintained alongside the code.

Vision Where the toolkit goes next. Permitting coverage Statute, jurisdiction, and project sector, drawn as a volume. Spatial context A section through the layer stack: what it holds, and what it does not.