National Parks MCP Server
Public Hosted Server: https://national-parks.caseyjhand.com/mcp
Overview
Plan a National Park Service trip: find a park, check alerts and closures, and browse campgrounds, activities, and events. Covers national parks, monuments, historic sites, and seashores, not state parks, Forest Service, or BLM land.
Tools
Tool | Description |
| Resolve a place name, US state, or free-text query to parks — the required first step. Returns each park's |
| Full detail for up to ten parks in one batched call: description, activities, fees & passes, hours, contacts, directions, weather overview, images. |
| Current alerts for a park or state — closures, hazards, caution, information — with category and recency surfaced first. |
| Campgrounds at a park or state: amenities, reservable vs. first-come site counts, reservation info, accessibility, and fees. |
| Curated things to do and points of interest: title, duration, location, accessibility, and fee/pet/reservation flags. |
| Scheduled events within a date range: dates/times, location, category, fee, and registration links. |
Related MCP server: National Parks MCP Server
Capability reference
nps_find_parks tool
Free-text
query, two-letterstateCode(or a comma-separated list such as"WY,MT,ID"), and an optionalactivityfilter;limit1–50 (default 10) with astartoffsetEach result includes the park code, designation, states, description, coordinates, activities, NPS page, and the amount and title of the first entrance fee NPS lists. Exact code or name matches rank first.
totalCountcounts every match.
nps_get_park tool
Up to 10
parkCodes per call; the optionalfieldsselector (activities,topics,fees,hours,contacts,directions,images) trims the payload to the sections you needCore fields include name, designation, states, description, coordinates, weather overview, and NPS page. Optional sections include fees and passes by category, weekly hours with dated exceptions for each area, contacts, and up to five images (
imagesTruncatedwhen more exist).Codes that match no site come back as
missingCodes; the call fails (no_parks_found) only when none resolve
nps_get_alerts tool
Filter by
parkCode,stateCode, free-textquery, andcategory(Danger,Caution,Information,Park Closure);limit1–50 (default 20) with astartoffsetMost-recent-first, each alert with its category,
lastIndexedDaterecency, and detail;categoryBreakdowncounts the returned alerts by severityThe notice tells an all-clear (no alerts at that location) apart from a filter that matched nothing and a page past the end
nps_find_campgrounds tool
Filter by
parkCode,stateCode, or free-textquery;limit1–50 (default 15) with astartoffsetEach campground lists weekly and seasonal hours, amenities, reservable and first-come sites, site types, electrical-hookup counts, RV and trailer length limits, and its first-listed fee and title. Reservation guidance and the booking link cover the next step.
nps_get_activities tool
A single
parkCodeor a singlestateCodeis required, plus an optionalquery;limit1–50 (default 15) with astartoffsetEach activity includes its location, season, duration, accessibility, fees, pet rules, and reservation or permit instructions. A shared activity carries the queried park code when NPS lists that park.
nps_find_events tool
Filter by
parkCode,stateCode, orquerywithin adateStart/dateEndwindow (YYYY-MM-DD); pages bypageNumberandpageSize(1–50, default 15), not by offsetEach event reports scheduled and cancelled dates within the window, series dates, time slots, location, category, fees, and registration instructions and links. A registration requirement can be present even when NPS supplies no URL.
Errors NPS reports alongside results fold into the notice instead of failing the call
Features
Built on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
NPS-specific:
One service wrapping the NPS Data API (
developer.nps.gov/api/v1,X-Api-Keyauth) across six trip-planning endpointsAggressive normalization of NPS's inconsistent payloads — numeric and boolean fields returned as strings, nested values (
campsites.totalSites), array-typed amenity fields, and the distinct/eventsenvelope with lowercased field names — coerced to clean domain types before they reach handlersnps_get_parkbatches up to ten park codes into a single upstream requestLight retry on transient upstream failures (5xx / network); a missing or invalid key fails loud and names
NPS_API_KEYCoordinates returned by
nps_find_parks/nps_get_parkfeed weather servers (nws-weather,open-meteo) for a forecast
Agent-friendly output:
Visit-planning guidance — the published
national-parks-guideskill checks park identity, access, reservation evidence, and event dates. It ships with plugins, npm, Docker, and MCPB, and MCP clients discover it through the Skills extension (skill://national-parks-guide/SKILL.md).Result-set context on every response —
totalCount, truncation (truncated/shown/cap), applied-filter echo, and empty-result notices reach both the structured and text surfacesMany parks list no campgrounds, curated activities, or events; an empty result comes back with a notice on where else to look, never as an error
The
parkCode-first workflow is encoded in every tool description;nps_get_parkreturnsmissingCodesso a wrong code self-correctsUncertainty preserved, never fabricated — missing coordinates, directions, fees, and amenity values come back
null, not a guess; coordinates are never invented for downstream weather lookups
Getting started
Connect to the hosted instance, no install:
claude mcp add --transport http national-parks-mcp-server https://national-parks.caseyjhand.com/mcpOr run it locally:
claude mcp add national-parks-mcp-server -e NPS_API_KEY=your-key -- npx -y @cyanheads/national-parks-mcp-serverFor other clients, add this to the MCP config file:
{
"mcpServers": {
"national-parks-mcp-server": {
"command": "npx",
"args": ["-y", "@cyanheads/national-parks-mcp-server"],
"env": {
"NPS_API_KEY": "your-api-key"
}
}
}
}Get a free NPS Data API key. For Docker or a source build, see Running the server.
Configuration
All configuration is validated at startup via Zod schemas. Key environment variables:
Variable | Description | Default |
| Required. NPS Data API key, sent as the | — |
| NPS Data API base URL override (testing / proxy). |
|
| Transport: |
|
| Port for the HTTP server. |
|
| Path where the MCP server is mounted. |
|
| Session handling: |
|
| Auth mode: |
|
| Log level (RFC 5424). |
|
| Directory for log files (Node.js only). |
|
| Log each failed tool call's arguments and result, redacted by key name and capped at |
|
| Storage backend: |
|
| Enable OpenTelemetry instrumentation (spans, metrics, completion logs). |
|
See .env.example for the full list of optional overrides.
Running the server
Local development
Requires Bun v1.4.4 or higher (or Node.js v24+) and an NPS Data API key.
Clone and install:
git clone https://github.com/cyanheads/national-parks-mcp-server.git cd national-parks-mcp-server && bun install cp .env.example .env # set NPS_API_KEYBuild and run:
# One-time build bun run rebuild # Run the built server bun run start:stdio # or bun run start:httpRun checks and tests:
bun run devcheck # Lint, format, typecheck, security bun run test # Vitest test suite bun run lint:mcp # Validate MCP definitions against spec
Docker
docker run --rm -e NPS_API_KEY=your-key -p 3010:3010 ghcr.io/cyanheads/national-parks-mcp-server:latestThe image defaults to HTTP transport, stateless session mode, and logs to /var/log/national-parks-mcp-server. To run over stdio, use docker run -i --rm -e MCP_TRANSPORT_TYPE=stdio -e NPS_API_KEY=your-key ghcr.io/cyanheads/national-parks-mcp-server:latest. Build locally with docker build -t national-parks-mcp-server .; OpenTelemetry peers are installed by default — add --build-arg OTEL_ENABLED=false to omit them.
Project structure
Directory | Purpose |
|
|
| Server-specific environment variable parsing and validation with Zod. |
| Tool definitions ( |
| NPS Data API service — HTTP client, retry boundary, error-envelope detection, and all upstream normalization. |
| Published visit-planning guidance for agents using the tools, also served over MCP. |
| Development guidance synced from the framework. |
| Unit and integration tests mirroring |
Development guide
See AGENTS.md / CLAUDE.md for development guidelines and architectural rules. The short version:
Handlers throw, framework catches — no
try/catchin tool logicUse
ctx.logfor request-scoped logging,ctx.statefor tenant-scoped storageRegister new tools in the
createApp()arraysWrap the external API: validate raw → normalize to domain type → return output schema; never fabricate missing fields
Data & attribution
Data is retrieved from the NPS Data API operated by the U.S. National Park Service. Content produced by NPS employees in their official capacity is a U.S. Government work in the public domain (17 U.S.C. §§ 101 and 105). No claim to original U.S. Government works.
Not all content returned by the API is government-authored. Some images and materials carry third-party copyright or other restrictions — check individual item rights before reuse.
The NPS Arrowhead symbol is a restricted mark protected under 18 U.S.C. § 701. It must not be reproduced or reused without written permission from the NPS Director.
Contributing
Issues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run testLicense
Apache-2.0 — see LICENSE for details.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Recreation.gov MCP — wraps the Recreation Information Database (RIDB) API v1…
NPS MCP — US National Park Service (free key, generous limits)
Query FDA data on drugs, food, devices, and recalls via openFDA. STDIO or Streamable HTTP.
Live US campground availability, wildfire and river conditions, and trails on public land.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceFacilitates retrieval of National Park Services data using the NPS API, allowing users to list national parks by state and access detailed information about specific parks.3ISC
- AlicenseBqualityDmaintenanceProvides real-time information about U.S. National Parks through the NPS API, enabling users to search parks, check details, alerts, visitor centers, campgrounds, and upcoming events.663 npm41MIT
- AlicenseNot gradedqualityDmaintenancePython based with all 29 tools that's available to developers from National Park Services (NPS)MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to the National Park Service API to search for U.S. national parks, view park details, check alerts and closures, find visitor centers, campgrounds, and upcoming events.MIT