what is mcp-server-nationalparks?
The mcp-server-nationalparks is a server project designed to provide data and services related to national parks, potentially for use in applications that require information about these parks.
how to use mcp-server-nationalparks?
To use the mcp-server-nationalparks, clone the repository from GitHub and follow the setup instructions provided in the documentation to run the server locally or deploy it to a cloud platform.
key features of mcp-server-nationalparks?
- Provides access to national park data.
- Supports various queries related to parks.
- Can be integrated with other applications for enhanced functionality.
use cases of mcp-server-nationalparks?
- Building a mobile app that provides information about national parks.
- Creating a website that showcases national parks and their features.
- Developing educational tools that teach users about national parks.
FAQ from mcp-server-nationalparks?
- What data does the server provide?
The server provides various data points related to national parks, including location, amenities, and visitor information.
- Is there a cost to use the server?
The server is open-source and free to use under the MIT license.
- How can I contribute to the project?
Contributions are welcome! You can fork the repository, make changes, and submit a pull request.
National Parks MCP Server
MCP Server for the National Park Service (NPS) API, providing real-time information about U.S. National Parks, including park details, alerts, and activities.
Tools
-
findParks
- Search for national parks based on various criteria
- Inputs:
stateCode
(optional string): Filter parks by state code (e.g., "CA" for California). Multiple states can be comma-separated (e.g., "CA,OR,WA")q
(optional string): Search term to filter parks by name or descriptionlimit
(optional number): Maximum number of parks to return (default: 10, max: 50)start
(optional number): Start position for results (useful for pagination)activities
(optional string): Filter by available activities (e.g., "hiking,camping")
- Returns: Matching parks with detailed information
-
getParkDetails
- Get comprehensive information about a specific national park
- Inputs:
parkCode
(string): The park code of the national park (e.g., "yose" for Yosemite, "grca" for Grand Canyon)
- Returns: Detailed park information including descriptions, hours, fees, contacts, and activities
-
getAlerts
- Get current alerts for national parks including closures, hazards, and important information
- Inputs:
parkCode
(optional string): Filter alerts by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")limit
(optional number): Maximum number of alerts to return (default: 10, max: 50)start
(optional number): Start position for results (useful for pagination)q
(optional string): Search term to filter alerts by title or description
- Returns: Current alerts organized by park
-
getVisitorCenters
- Get information about visitor centers and their operating hours
- Inputs:
parkCode
(optional string): Filter visitor centers by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")limit
(optional number): Maximum number of visitor centers to return (default: 10, max: 50)start
(optional number): Start position for results (useful for pagination)q
(optional string): Search term to filter visitor centers by name or description
- Returns: Visitor center information including location, hours, and contact details
-
getCampgrounds
- Get information about available campgrounds and their amenities
- Inputs:
parkCode
(optional string): Filter campgrounds by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")limit
(optional number): Maximum number of campgrounds to return (default: 10, max: 50)start
(optional number): Start position for results (useful for pagination)q
(optional string): Search term to filter campgrounds by name or description
- Returns: Campground information including amenities, fees, and reservation details
-
getEvents
- Find upcoming events at parks
- Inputs:
parkCode
(optional string): Filter events by park code (e.g., "yose" for Yosemite). Multiple parks can be comma-separated (e.g., "yose,grca")limit
(optional number): Maximum number of events to return (default: 10, max: 50)start
(optional number): Start position for results (useful for pagination)dateStart
(optional string): Start date for filtering events (format: YYYY-MM-DD)dateEnd
(optional string): End date for filtering events (format: YYYY-MM-DD)q
(optional string): Search term to filter events by title or description
- Returns: Event information including dates, times, and descriptions
Setup
Installing via Smithery
To install mcp-server-nationalparks for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @KyrieTangSheng/mcp-server-nationalparks --client claude
NPS API Key
- Get a free API key from the National Park Service Developer Portal
- Store this key securely as it will be used to authenticate requests
Usage with Claude Desktop
To use this server with Claude Desktop, add the following to your claude_desktop_config.json
:
{
"mcpServers": {
"nationalparks": {
"command": "npx",
"args": ["-y", "mcp-server-nationalparks"],
"env": {
"NPS_API_KEY": "YOUR_NPS_API_KEY"
}
}
}
}
Example Usage
Finding Parks in a State
Tell me about national parks in Colorado.
Getting Details About a Specific Park
What's the entrance fee for Yellowstone National Park?
Checking for Alerts or Closures
Are there any closures or alerts at Yosemite right now?
Finding Visitor Centers
What visitor centers are available at Grand Canyon National Park?
Looking for Campgrounds
Are there any campgrounds with electrical hookups in Zion National Park?
Finding Upcoming Events
What events are happening at Acadia National Park next weekend?
Planning a Trip Based on Activities
Which national parks in Utah have good hiking trails?
License
This MCP server is licensed under the MIT License. See the LICENSE file for details.
Appendix: Popular National Parks and their codes
Park Name | Park Code |
---|---|
Yosemite | yose |
Grand Canyon | grca |
Yellowstone | yell |
Zion | zion |
Great Smoky Mountains | grsm |
Acadia | acad |
Olympic | olym |
Rocky Mountain | romo |
Joshua Tree | jotr |
Sequoia & Kings Canyon | seki |
For a complete list, visit the NPS website.