Server definition
- Hash
- sha256:fcfd05b9becfdfe5d103594c108322a71215f2b2d65f46d2c0c6ee5bd01c1db2
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "Plan a US National Park Service trip. Coverage is US NPS sites only — national parks, monuments, historic sites, seashores — not state parks, Forest Service, or BLM land. The workflow is parkCode-first: call nps_find_parks to resolve a place/state/query into a parkCode, then key nps_get_park, nps_get_alerts, nps_find_campgrounds, nps_get_activities, and nps_find_events on that code. nps_get_alerts is time-sensitive (closures change daily). Park coordinates returned by nps_find_parks / nps_get_park feed weather servers (nws-weather, open-meteo) for a forecast.",
"tools": [
{
"description": "Campgrounds at a park or across a state: amenities (potable water, showers, RV dump station, toilets, trash collection, RV access), reservable vs. first-come-first-served site counts, reservation guidance and booking URL, accessibility, and fees — answering \"where can I camp at Zion, and can I get an RV hookup?\" Get park codes from nps_find_parks. Some parks list lodging or backcountry permits instead of NPS-managed campgrounds; an empty result is not an error.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 15,
"description": "Maximum campgrounds to return (1–50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"parkCode": {
"description": "Park code, or comma-separated list (e.g. \"zion\") — 4-letter lowercase codes. Get codes from nps_find_parks. Provide parkCode or stateCode.",
"type": "string"
},
"query": {
"description": "Free-text search across campground names/descriptions (e.g. \"river\", \"group\", \"rv\").",
"type": "string"
},
"start": {
"default": 0,
"description": "Zero-based pagination offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"stateCode": {
"description": "Two-letter state code, or comma-separated list. Returns campgrounds across all NPS sites in those states.",
"type": "string"
}
},
"type": "object"
},
"name": "nps_find_campgrounds",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"campgrounds",
"totalCount",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"description": "Echo of parkCode/stateCode/query as applied.",
"type": "string"
},
"campgrounds": {
"description": "Campgrounds at the requested park(s)/state(s).",
"items": {
"additionalProperties": false,
"description": "A single campground with amenities, site counts, and reservation info.",
"properties": {
"accessibility": {
"description": "Free-text accessibility summary, or null if NPS publishes none.",
"type": [
"string",
"null"
]
},
"amenities": {
"additionalProperties": false,
"description": "Key amenities: true, false, or null when NPS published no value (unknown, not absent). The campground's NPS page has the full amenity list.",
"properties": {
"dumpStation": {
"description": "RV dump station available, or null when NPS published no value.",
"type": [
"boolean",
"null"
]
},
"potableWater": {
"description": "Drinking water available on site, or null when NPS published no value.",
"type": [
"boolean",
"null"
]
},
"rvAllowed": {
"description": "RVs permitted, or null when NPS published no value.",
"type": [
"boolean",
"null"
]
},
"showers": {
"description": "Showers available, or null when NPS published no value.",
"type": [
"boolean",
"null"
]
},
"toilets": {
"description": "Toilets of any type (flush, vault, portable, composting) available, or null when NPS published no value.",
"type": [
"boolean",
"null"
]
},
"trashCollection": {
"description": "Trash/recycling collection on site, or null when NPS published no value.",
"type": [
"boolean",
"null"
]
}
},
"required": [
"potableWater",
"showers",
"dumpStation",
"rvAllowed",
"toilets",
"trashCollection"
],
"type": "object"
},
"description": {
"description": "Short campground description.",
"type": "string"
},
"fee": {
"description": "Lowest campground fee as a dollar string (e.g. \"30.00\"), or null if free / unspecified.",
"type": [
"string",
"null"
]
},
"firstComeSites": {
"description": "Number of first-come-first-served sites, or null.",
"type": [
"number",
"null"
]
},
"id": {
"description": "Campground ID.",
"type": "string"
},
"latitude": {
"description": "Latitude (decimal degrees) or null.",
"type": [
"number",
"null"
]
},
"longitude": {
"description": "Longitude (decimal degrees) or null.",
"type": [
"number",
"null"
]
},
"name": {
"description": "Campground name (e.g. \"Watchman Campground\").",
"type": "string"
},
"parkCode": {
"description": "Park code the campground belongs to.",
"type": "string"
},
"reservableSites": {
"description": "Number of reservable sites, or null. 0 means first-come-first-served only.",
"type": [
"number",
"null"
]
},
"reservationInfo": {
"description": "Free-text reservation guidance (how/where to book), or null.",
"type": [
"string",
"null"
]
},
"reservationUrl": {
"description": "Booking URL (often recreation.gov), or null.",
"type": [
"string",
"null"
]
},
"totalSites": {
"description": "Total number of campsites, or null if unspecified.",
"type": [
"number",
"null"
]
},
"url": {
"description": "Campground's NPS.gov page with the full amenity and site detail, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name",
"parkCode",
"description",
"latitude",
"longitude",
"totalSites",
"reservableSites",
"firstComeSites",
"reservationInfo",
"reservationUrl",
"fee",
"amenities",
"accessibility",
"url"
],
"type": "object"
},
"type": "array"
},
"cap": {
"description": "Limit applied (populated when results were truncated).",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_park_code`: A parkCode token isn't 4 lowercase letters. `invalid_state_code`: A stateCode token isn't two letters. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_park_code",
"invalid_state_code"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance on the result set: where else to look when no campgrounds matched, the start value for the next page when more matched, or the way back when start ran past the end.",
"type": "string"
},
"shown": {
"description": "Campgrounds returned in this response (populated when capped by limit).",
"type": "number"
},
"totalCount": {
"description": "Total campgrounds matching the filter before the limit was applied.",
"type": "number"
},
"truncated": {
"description": "True when more campgrounds matched than this response returned; absent on a complete result.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Scheduled events at a park within a date range — ranger programs, festivals, tours, interpretive events — answering \"what's happening at Yellowstone this weekend?\" with title, dates and times, location, category, fee, and registration links. Get park codes from nps_find_parks. Paginates by page number, not offset. Many parks list few or no events; an empty result is not an error.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"dateEnd": {
"description": "End of the date window (YYYY-MM-DD). Use with dateStart.",
"type": "string"
},
"dateStart": {
"description": "Start of the date window (YYYY-MM-DD). Combine with dateEnd to bound the search (e.g. a weekend). Omit for upcoming events from today.",
"type": "string"
},
"pageNumber": {
"default": 1,
"description": "1-based page number. Increment to page through results beyond the first page.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"pageSize": {
"default": 15,
"description": "Maximum events to return per page (1–50). Paginates by page number, not offset — use with pageNumber to walk through results.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"parkCode": {
"description": "Park code, or comma-separated list (e.g. \"yell\") — 4-letter lowercase codes. Get codes from nps_find_parks. Provide parkCode or stateCode.",
"type": "string"
},
"query": {
"description": "Free-text search across event titles/descriptions (e.g. \"ranger\", \"astronomy\", \"guided\").",
"type": "string"
},
"stateCode": {
"description": "Two-letter state code, or comma-separated list (e.g. \"WY\", \"WY,MT,ID\"). Returns events across NPS sites in those states.",
"type": "string"
}
},
"type": "object"
},
"name": "nps_find_events",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"events",
"totalCount",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"description": "Echo of parkCode/stateCode/date window/query as applied.",
"type": "string"
},
"cap": {
"description": "Page size applied (populated when results were truncated).",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_date`: dateStart/dateEnd not YYYY-MM-DD, not a real calendar date (e.g. 2026-02-31), or dateEnd < dateStart. `invalid_park_code`: A parkCode token isn't 4 lowercase letters. `invalid_state_code`: A stateCode token isn't two letters. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_date",
"invalid_park_code",
"invalid_state_code"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"events": {
"description": "Events matching the park/state and date window.",
"items": {
"additionalProperties": false,
"description": "A single scheduled event with dates, times, and registration links.",
"properties": {
"category": {
"description": "Event category (e.g. \"Regular Event\", \"Ranger Programs\"), or null.",
"type": [
"string",
"null"
]
},
"dateEnd": {
"description": "Event end date (YYYY-MM-DD), or null. For a recurring event this is the anchor date, not the last occurrence — see occurrenceDates and isRecurring.",
"type": [
"string",
"null"
]
},
"dateStart": {
"description": "Event start date (YYYY-MM-DD), or null. For a recurring event this is the series anchor (its original first date), which can predate your requested window — use occurrenceDates for the dates that actually fall in the window.",
"type": [
"string",
"null"
]
},
"description": {
"description": "Event description as plain text.",
"type": "string"
},
"feeInfo": {
"description": "Fee details when not free (free text), or null.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Event ID.",
"type": "string"
},
"infoUrl": {
"description": "More-info URL, or null.",
"type": [
"string",
"null"
]
},
"isFree": {
"description": "Whether the event is free.",
"type": "boolean"
},
"isRecurring": {
"description": "True when this is a recurring series (multiple occurrence dates); dateStart/dateEnd then hold the series anchor and occurrenceDates the actual dates.",
"type": "boolean"
},
"location": {
"description": "Event location within the park (free text), or null.",
"type": [
"string",
"null"
]
},
"occurrenceDates": {
"description": "Dates (YYYY-MM-DD) the event actually occurs within the requested dateStart/dateEnd window; with no window, every remaining occurrence from today through the series end. Empty when the window matches no occurrence. For a recurring series, dateStart/dateEnd hold the series anchor instead.",
"items": {
"type": "string"
},
"type": "array"
},
"parkCode": {
"description": "Park code the event belongs to, or null if absent.",
"type": [
"string",
"null"
]
},
"registrationUrl": {
"description": "Registration/reservation URL, or null.",
"type": [
"string",
"null"
]
},
"times": {
"description": "Scheduled time slots for the event. May be empty (all-day or unspecified).",
"items": {
"additionalProperties": false,
"description": "A single scheduled time slot.",
"properties": {
"timeEnd": {
"description": "End time (e.g. \"02:30 PM\").",
"type": "string"
},
"timeStart": {
"description": "Start time (e.g. \"02:00 PM\").",
"type": "string"
}
},
"required": [
"timeStart",
"timeEnd"
],
"type": "object"
},
"type": "array"
},
"title": {
"description": "Event title.",
"type": "string"
}
},
"required": [
"id",
"title",
"parkCode",
"description",
"location",
"dateStart",
"dateEnd",
"occurrenceDates",
"isRecurring",
"times",
"category",
"isFree",
"feeInfo",
"registrationUrl",
"infoUrl"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Guidance on the result set: how to widen a search that matched nothing, the pageNumber for the next page when more events matched, the way back when pageNumber ran past the end, and a warning when NPS reports errors for the request.",
"type": "string"
},
"shown": {
"description": "Events returned on this page (populated when the page was capped by pageSize).",
"type": "number"
},
"totalCount": {
"description": "Total events matching the filter before the page limit.",
"type": "number"
},
"truncated": {
"description": "True when more matching events follow this page; absent on the last page of the result.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Resolve a place name, US state, or free-text query to National Park Service parks — the required first step before the detail tools. Returns each park's parkCode (the key nps_get_park, nps_get_alerts, nps_find_campgrounds, nps_get_activities, and nps_find_events all use) plus a compact trip-planning summary (designation, states, description, coordinates, headline activities, entrance fee, NPS page). Coverage is US NPS sites only — national parks, monuments, historic sites, seashores — not state parks and not Forest Service or BLM land.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"activity": {
"description": "Filter to parks offering an activity, matched against each park's activities list (e.g. \"hiking\", \"camping\", \"stargazing\"). Case-insensitive substring match, combined with query/stateCode and applied before start/limit, so totalCount counts every matching park, not one page. Use nps_get_park to see a park's full activity list.",
"type": "string"
},
"limit": {
"default": 10,
"description": "Maximum parks to return (1–50). The full set is ~470 sites; narrow with query/stateCode rather than paging through everything.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Free-text search across park names and descriptions (e.g. \"yosemite\", \"civil war\", \"redwood\"). Exact parkCode or name matches lead, then other name matches, then parks that only mention the term in their description — ranked across every match before start/limit apply. Omit to browse by state. At least one of query or stateCode is recommended; with neither, returns the first page of all ~470 NPS sites.",
"type": "string"
},
"start": {
"default": 0,
"description": "Zero-based offset for pagination within the matched set. Use with limit to page through results.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"stateCode": {
"description": "Two-letter US state/territory code, or comma-separated list (e.g. \"CA\", \"WY,MT,ID\"). Filters to parks located in those states. Combine with query to narrow.",
"type": "string"
}
},
"type": "object"
},
"name": "nps_find_parks",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"parks",
"totalCount",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"appliedFilters": {
"description": "Echo of the filters as applied (query / stateCode / activity).",
"type": "string"
},
"cap": {
"description": "The limit applied to this response (populated when results were truncated).",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_state_code`: A stateCode token is not two letters. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_state_code"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance on the result set: how to broaden a search that matched nothing, the start value for the next page when more parks matched, the way back when start ran past the end, and a best-effort disclosure when the activity scan could not cover every site.",
"type": "string"
},
"parks": {
"description": "Matching parks, each carrying the parkCode needed to chain into the detail tools.",
"items": {
"additionalProperties": false,
"description": "A matching park with its parkCode and trip-planning summary.",
"properties": {
"activities": {
"description": "Activity names available at the park (e.g. \"Hiking\", \"Camping\"). May be empty.",
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"description": "Short park description.",
"type": "string"
},
"designation": {
"description": "Site type (e.g. \"National Park\", \"National Monument\", \"National Historic Site\"). Empty string for sites without a designation.",
"type": "string"
},
"entranceFee": {
"description": "Lowest standard entrance fee as a dollar string (e.g. \"35.00\"), or null if the park is fee-free or lists no fee. Full fee/pass breakdown is in nps_get_park.",
"type": [
"string",
"null"
]
},
"fullName": {
"description": "Full official name (e.g. \"Yosemite National Park\").",
"type": "string"
},
"latitude": {
"description": "Center latitude (decimal degrees), or null if the park record has no coordinates.",
"type": [
"number",
"null"
]
},
"longitude": {
"description": "Center longitude (decimal degrees), or null if absent.",
"type": [
"number",
"null"
]
},
"parkCode": {
"description": "Park code — the key for nps_get_park, nps_get_alerts, nps_find_campgrounds, nps_get_activities, nps_find_events (e.g. \"yose\").",
"type": "string"
},
"states": {
"description": "Comma-separated state codes the park spans (e.g. \"CA\", \"WY,MT,ID\").",
"type": "string"
},
"url": {
"description": "Park's official NPS.gov page, with fuller detail than this summary.",
"type": "string"
}
},
"required": [
"parkCode",
"fullName",
"designation",
"states",
"description",
"latitude",
"longitude",
"activities",
"entranceFee",
"url"
],
"type": "object"
},
"type": "array"
},
"shown": {
"description": "Number of parks returned in this response (populated when the result set was capped by limit).",
"type": "number"
},
"totalCount": {
"description": "Total parks matching every filter, before start/limit were applied.",
"type": "number"
},
"truncated": {
"description": "True when more parks matched than this response returned; absent on a complete result.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Curated things to do and points of interest at a park — title, description, time commitment, location, accessibility, and fee/pet/reservation flags — answering \"what should I do at Acadia?\" Covers the NPS editorially-curated activity list (distinct from a park's raw activity tags in nps_get_park). Accepts a single 4-letter park code or a single two-letter state code, and at least one is required. Not every park has a curated list; an empty result is not an error.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 15,
"description": "Maximum activities to return (1–50).",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"parkCode": {
"description": "A single 4-letter lowercase park code (e.g. \"acad\"). Get it from nps_find_parks. Accepts one park code, not a list. Provide parkCode or stateCode.",
"type": "string"
},
"query": {
"description": "Free-text search across activity titles/descriptions (e.g. \"sunrise\", \"hike\", \"tour\").",
"type": "string"
},
"start": {
"default": 0,
"description": "Zero-based pagination offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"stateCode": {
"description": "A single two-letter state code (e.g. \"ME\"). Returns curated activities across NPS sites in that state.",
"type": "string"
}
},
"type": "object"
},
"name": "nps_get_activities",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"activities",
"totalCount",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"activities": {
"description": "Curated activities and points of interest for the requested park/state.",
"items": {
"additionalProperties": false,
"description": "A single curated activity or point of interest.",
"properties": {
"accessibility": {
"description": "Accessibility information (free text), or null.",
"type": [
"string",
"null"
]
},
"duration": {
"description": "Time commitment (e.g. \"1-3 Hours\"), or null.",
"type": [
"string",
"null"
]
},
"feeDescription": {
"description": "Fee info if any (free text), or null. Absence does not guarantee free — check the park page.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Activity ID.",
"type": "string"
},
"latitude": {
"description": "Activity latitude (decimal degrees) or null.",
"type": [
"number",
"null"
]
},
"location": {
"description": "Where in the park this happens (free text), or null.",
"type": [
"string",
"null"
]
},
"longitude": {
"description": "Activity longitude (decimal degrees) or null.",
"type": [
"number",
"null"
]
},
"parkCode": {
"description": "Park code the activity belongs to, or null if absent.",
"type": [
"string",
"null"
]
},
"petsPermitted": {
"description": "Whether pets are permitted.",
"type": "boolean"
},
"reservationRequired": {
"description": "Whether a reservation is required.",
"type": "boolean"
},
"season": {
"description": "Seasons when the activity is available (e.g. [\"Summer\", \"Fall\"]). May be empty.",
"items": {
"type": "string"
},
"type": "array"
},
"shortDescription": {
"description": "Concise description of the activity.",
"type": "string"
},
"title": {
"description": "Activity title (e.g. \"Watch the Sunrise from Cadillac Mountain\").",
"type": "string"
},
"url": {
"description": "Activity's NPS.gov page, or null.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"title",
"parkCode",
"shortDescription",
"location",
"latitude",
"longitude",
"duration",
"reservationRequired",
"feeDescription",
"petsPermitted",
"accessibility",
"season",
"url"
],
"type": "object"
},
"type": "array"
},
"appliedFilters": {
"description": "Echo of parkCode/stateCode/query as applied.",
"type": "string"
},
"cap": {
"description": "Limit applied (populated when results were truncated).",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `missing_filter`: Neither parkCode nor stateCode provided. `invalid_park_code`: parkCode isn't a single 4-letter lowercase code. `invalid_state_code`: stateCode isn't a single two-letter code. Other values are possible when a failure originates below the handler.",
"examples": [
"missing_filter",
"invalid_park_code",
"invalid_state_code"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance on the result set: where else to look when no curated activities matched, the start value for the next page when more matched, or the way back when start ran past the end.",
"type": "string"
},
"shown": {
"description": "Activities returned in this response (populated when capped by limit).",
"type": "number"
},
"totalCount": {
"description": "Total activities matching the filter before the limit was applied.",
"type": "number"
},
"truncated": {
"description": "True when more activities matched than this response returned; absent on a complete result.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Current alerts for a park or a whole state — closures, hazards, caution notices, and information — with category and recency surfaced first so \"is anything closed at Glacier right now?\" is answered at a glance. Get park codes from nps_find_parks, or pass a stateCode for a statewide \"what's closed\" sweep. Returns most-recent-first. An empty result with totalCount 0 means no active alerts match the request (with category or query set, alerts outside that filter may still be active); an empty page with a non-zero totalCount means start ran past the end of the matches. Closures and road conditions change daily.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"category": {
"description": "Filter to one alert category. \"Danger\" and \"Park Closure\" are trip-affecting. Combined with parkCode/stateCode/query and applied before start/limit, so totalCount counts every matching alert, not one page. Omit to see all categories.",
"enum": [
"Danger",
"Caution",
"Information",
"Park Closure"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Maximum alerts to return (1–50), most-recent first.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"parkCode": {
"description": "Park code, or comma-separated list (e.g. \"glac\", \"yose,zion\") — 4-letter lowercase codes. Get codes from nps_find_parks. Provide parkCode or stateCode; with neither, returns recent alerts service-wide.",
"type": "string"
},
"query": {
"description": "Free-text search within alert titles/descriptions (e.g. \"road\", \"wildfire\", \"trail\").",
"type": "string"
},
"start": {
"default": 0,
"description": "Zero-based offset for pagination within the matched set. Use with limit to page through results — when totalCount exceeds what was returned, re-request with start advanced by limit.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"stateCode": {
"description": "Two-letter state code, or comma-separated list (e.g. \"MT\", \"WY,MT,ID\"). Returns alerts for all NPS sites in those states — use for a statewide sweep rather than one park.",
"type": "string"
}
},
"type": "object"
},
"name": "nps_get_alerts",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"alerts",
"totalCount",
"categoryBreakdown",
"appliedFilters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"alerts": {
"description": "Current alerts, most-recent first. Empty with totalCount 0 means no active alerts match the request; empty with a non-zero totalCount means start ran past the end of the matches.",
"items": {
"additionalProperties": false,
"description": "A single alert with its category, recency, and detail.",
"properties": {
"category": {
"description": "Alert category: \"Danger\", \"Park Closure\", \"Caution\", or \"Information\". Danger and Park Closure are trip-affecting.",
"type": "string"
},
"description": {
"description": "Full alert text — what is affected and any guidance.",
"type": "string"
},
"id": {
"description": "Alert ID.",
"type": "string"
},
"lastIndexedDate": {
"description": "When NPS last updated/indexed this alert (YYYY-MM-DD), or null. The recency signal — a stale date may mean the condition has changed.",
"type": [
"string",
"null"
]
},
"parkCode": {
"description": "Park code the alert belongs to — useful when querying by state across multiple parks.",
"type": "string"
},
"title": {
"description": "Short alert headline (e.g. \"Tioga Road Closed for the Season\").",
"type": "string"
},
"url": {
"description": "Link to more detail on NPS.gov, or null when absent.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"parkCode",
"category",
"title",
"description",
"url",
"lastIndexedDate"
],
"type": "object"
},
"type": "array"
},
"appliedFilters": {
"description": "Echo of parkCode/stateCode/category/query as applied.",
"type": "string"
},
"cap": {
"description": "Limit applied (populated when results were truncated).",
"type": "number"
},
"categoryBreakdown": {
"description": "Count of returned alerts per category, most severe first (e.g. \"Park Closure: 3, Caution: 1, Information: 2\").",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_park_code`: A parkCode token isn't 4 lowercase letters. `invalid_state_code`: A stateCode token isn't two letters. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_park_code",
"invalid_state_code"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance on the result set: whether an empty page means no active alerts match (totalCount 0) or start ran past the end of the matches, the start value for the next page when more alerts matched, and a best-effort disclosure when the category filter could not cover every alert.",
"type": "string"
},
"shown": {
"description": "Alerts returned in this response (populated when capped by limit).",
"type": "number"
},
"totalCount": {
"description": "Total alerts matching the filter before the limit was applied.",
"type": "number"
},
"truncated": {
"description": "True when more alerts matched than this response returned; absent on a complete result.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Full trip-planning detail for one or more parks by parkCode: description, activities and topics, entrance fees and passes, operating hours by area/season, contacts, directions, a free-text weather overview, representative images, and the NPS page for everything else. Get codes from nps_find_parks. Accepts up to ten codes per call. Use the fields parameter to return only the sections you need.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"fields": {
"description": "Optional detail sections to include beyond the always-present core (name, designation, states, description, coordinates, weather, url). Omit for all sections. Narrow to reduce payload when you only need, say, hours and fees.",
"items": {
"enum": [
"activities",
"topics",
"fees",
"hours",
"contacts",
"directions",
"images"
],
"type": "string"
},
"type": "array"
},
"parkCode": {
"description": "One to ten park codes per call, each a 4-letter lowercase code (e.g. \"yose\", \"grca\", \"zion\"). Get codes from nps_find_parks.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
},
"required": [
"parkCode"
],
"type": "object"
},
"name": "nps_get_park",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"parks",
"requestedCount",
"returnedCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `invalid_park_code`: A parkCode element isn't 4 lowercase letters. `no_parks_found`: None of the requested codes matched an NPS site. Other values are possible when a failure originates below the handler.",
"examples": [
"invalid_park_code",
"no_parks_found"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"missingCodes": {
"description": "Requested park codes that matched no NPS site — likely misspelled. Populated only when some codes did not resolve.",
"items": {
"type": "string"
},
"type": "array"
},
"notice": {
"description": "Guidance when one or more codes did not resolve, or when none did.",
"type": "string"
},
"parks": {
"description": "Requested parks with trip-planning detail.",
"items": {
"additionalProperties": false,
"description": "One park with its trip-planning detail.",
"properties": {
"activities": {
"description": "Activity names (included unless fields excludes \"activities\").",
"items": {
"type": "string"
},
"type": "array"
},
"contacts": {
"additionalProperties": false,
"description": "Park contact info (included unless fields excludes \"contacts\").",
"properties": {
"emailAddresses": {
"description": "Email contacts. May be empty.",
"items": {
"additionalProperties": false,
"description": "A single email contact.",
"properties": {
"emailAddress": {
"description": "The email address.",
"type": "string"
}
},
"required": [
"emailAddress"
],
"type": "object"
},
"type": "array"
},
"phoneNumbers": {
"description": "Phone contacts. May be empty.",
"items": {
"additionalProperties": false,
"description": "A single phone contact.",
"properties": {
"phoneNumber": {
"description": "The number.",
"type": "string"
},
"type": {
"description": "Type (e.g. \"Voice\", \"Fax\").",
"type": "string"
}
},
"required": [
"phoneNumber",
"type"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"phoneNumbers",
"emailAddresses"
],
"type": "object"
},
"description": {
"description": "Full park description.",
"type": "string"
},
"designation": {
"description": "Site type (e.g. \"National Park\"). Empty string if none.",
"type": "string"
},
"directionsInfo": {
"description": "Free-text driving/access directions, or null when NPS publishes none (included unless fields excludes \"directions\").",
"type": [
"string",
"null"
]
},
"directionsUrl": {
"description": "NPS directions page URL, or null when NPS publishes none (included unless fields excludes \"directions\").",
"type": [
"string",
"null"
]
},
"entranceFees": {
"description": "Entrance fees by category (included unless fields excludes \"fees\"). Empty array means the park lists no entrance fee.",
"items": {
"additionalProperties": false,
"description": "A single entrance fee category.",
"properties": {
"cost": {
"description": "Fee amount as a dollar string (e.g. \"35.00\"). \"0.00\" means no charge for that category.",
"type": "string"
},
"description": {
"description": "What the fee covers and for how long.",
"type": "string"
},
"title": {
"description": "Fee title (e.g. \"Entrance - Private Vehicle\").",
"type": "string"
}
},
"required": [
"cost",
"title",
"description"
],
"type": "object"
},
"type": "array"
},
"entrancePasses": {
"description": "Annual/park-specific passes (included unless fields excludes \"fees\"). May be empty.",
"items": {
"additionalProperties": false,
"description": "A single annual or park-specific pass.",
"properties": {
"cost": {
"description": "Pass cost as a dollar string.",
"type": "string"
},
"description": {
"description": "Pass coverage and validity.",
"type": "string"
},
"title": {
"description": "Pass title (e.g. \"Yosemite Annual Pass\").",
"type": "string"
}
},
"required": [
"cost",
"title",
"description"
],
"type": "object"
},
"type": "array"
},
"fullName": {
"description": "Full official park name.",
"type": "string"
},
"images": {
"description": "Representative park images (included unless fields excludes \"images\"). Capped at 5; imagesTruncated flags when the park has more. May be empty.",
"items": {
"additionalProperties": false,
"description": "A single representative park image.",
"properties": {
"altText": {
"description": "Alt text / caption.",
"type": "string"
},
"title": {
"description": "Image title.",
"type": "string"
},
"url": {
"description": "Image URL.",
"type": "string"
}
},
"required": [
"url",
"altText",
"title"
],
"type": "object"
},
"type": "array"
},
"imagesTruncated": {
"description": "True when the park has more than the 5 images returned here; the park url has the full set. Present only when the images section is included.",
"type": "boolean"
},
"latitude": {
"description": "Center latitude (decimal degrees) or null.",
"type": [
"number",
"null"
]
},
"longitude": {
"description": "Center longitude (decimal degrees) or null.",
"type": [
"number",
"null"
]
},
"operatingHours": {
"description": "Operating hours by area/season (included unless fields excludes \"hours\"). May be empty.",
"items": {
"additionalProperties": false,
"description": "Operating hours for one area or season.",
"properties": {
"description": {
"description": "Free-text hours/seasonality notes.",
"type": "string"
},
"name": {
"description": "Schedule name (e.g. \"Yosemite Valley\").",
"type": "string"
},
"standardHours": {
"additionalProperties": false,
"description": "Per-weekday operating hours. Values are free-text strings from NPS.",
"properties": {
"friday": {
"description": "Friday hours.",
"type": "string"
},
"monday": {
"description": "Monday hours (e.g. \"All Day\", \"Closed\", \"9:00AM - 5:00PM\").",
"type": "string"
},
"saturday": {
"description": "Saturday hours.",
"type": "string"
},
"sunday": {
"description": "Sunday hours.",
"type": "string"
},
"thursday": {
"description": "Thursday hours.",
"type": "string"
},
"tuesday": {
"description": "Tuesday hours.",
"type": "string"
},
"wednesday": {
"description": "Wednesday hours.",
"type": "string"
}
},
"required": [
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday",
"sunday"
],
"type": "object"
}
},
"required": [
"name",
"description",
"standardHours"
],
"type": "object"
},
"type": "array"
},
"parkCode": {
"description": "Park code (echoes the request).",
"type": "string"
},
"states": {
"description": "Comma-separated state codes the park spans.",
"type": "string"
},
"topics": {
"description": "Topic names — what the park is about, e.g. \"Volcanoes\", \"Civil War\" (included unless fields excludes \"topics\").",
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"description": "Park's official NPS.gov page.",
"type": "string"
},
"weatherOverview": {
"description": "NPS free-text weather/seasonal overview for the park, or null. General seasonal guidance, not a forecast.",
"type": [
"string",
"null"
]
}
},
"required": [
"parkCode",
"fullName",
"designation",
"states",
"description",
"latitude",
"longitude",
"weatherOverview",
"url"
],
"type": "object"
},
"type": "array"
},
"requestedCount": {
"description": "Number of park codes requested.",
"type": "number"
},
"returnedCount": {
"description": "Number of requested parks found.",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:fcfd05b9becfdfe5d103594c108322a71215f2b2d65f46d2c0c6ee5bd01c1db2 | sha256sum