View Source Repository
PermitAI™

NEPA MCP Toolkit

14 Federal Agencies 23 Servers 88 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.

Four steps · one-time setup

Quick Start

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

1

Install

one-time

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

PyPI v0.1.6 
pipx install nepa-mcp
pipx ensurepath

Reopen the terminal if ensurepath changes your PATH. If pipx picks an older Python, add the --python 3.12 flag.

2

Verify

before you connect

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

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

Run nepa-mcp list-servers for the full table. The amber lines are optional keys — add them below, or skip them.

Optional Some servers need a free API key census and epa_aqs only. Keys are free and issued immediately.
census
CENSUS_API_KEY Request a key
epa_aqs
EPA_AQS_EMAILEPA_AQS_API_KEY Register
writes credentials.env 
nepa-mcp configure credentials
nepa-mcp doctor

Read from your per-user credentials.env or the shell environment, never copied into client or plugin config.

3

Connect your client

per project

Run it from your project root.

Codex Desktop
4

Ask a question

first prompt
Instead of step 3

Codex Desktop plugin

One install for all 23 servers and the screening skill

GitHub marketplace

The repository is itself a GitHub-hosted plugin marketplace. One install registers all 23 servers and the nepa-screening skill, which tells the agent how to establish a project area and pick the right datasets.

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

In Codex Desktop, after pipx install nepa-mcp:

  1. Open Plugins and select Add plugin marketplace.

  2. Enter pnnl/nepa-mcp for Source and v0.1.6 for Git ref.

  3. Add the marketplace, then install NEPA-MCP.

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

If you install the plugin, do not also run nepa-mcp configure codex. No Desktop app? The README has the equivalent codex plugin commands.

Selected public data sources

Explore the toolkit's data sources and subsources →

MCP Servers

Twenty-three 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 56 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.

Look ahead 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.