{"name":"peaks.fyi","version":"3.1.0","quickStart":{"name":"peaks.fyi","authentication":"none","instructions":"Use these read-only HTTP APIs directly. No account, browser JavaScript, skill or MCP installation is required. Find the user's mountain by search, then use its returned slug. Do not guess slugs. GET parameters are strings; arrays/objects use JSON. POST accepts the same parameters as JSON. If your reader refuses URLs it has not previously seen, follow nameInitialLinks instead; those pages link directly to data APIs.","mcp":{"url":"https://peaks.fyi/mcp","transport":"Streamable HTTP","authentication":"none"},"endpoints":{"search":{"url":"https://peaks.fyi/api/agent/search","parameters":{"query":"Mountain name, alias, region, or user's request"}},"weather":{"url":"https://peaks.fyi/api/agent/get_weather","parameters":{"slug":"From search","view":"compact for short responses; full for auxiliary point fields","targetId":"summit, or omit for all altitudes","start":"Optional ISO 8601 timestamp with timezone, inclusive","end":"Optional ISO 8601 timestamp with timezone, exclusive"},"instruction":"Use the peak's timezone to resolve relative dates. Inspect coverage, units, issuedAt and limitations. Historical seasons are not forecasts."},"peak":{"url":"https://peaks.fyi/api/agent/get_peak","parameters":{"slug":"From search","sections":"Optional JSON array: overview, routes, seasons, access, huts, hazards, notices, provenance"}},"huts":{"url":"https://peaks.fyi/api/agent/get_huts","parameters":{"slug":"From search"},"instruction":"Booking contacts are not confirmed availability."},"route":{"url":"https://peaks.fyi/api/agent/get_route","parameters":{"slug":"From search","routeId":"From get_peak or search_routes"}},"routeSearch":{"url":"https://peaks.fyi/api/agent/search_routes","parameters":{"query":"Region or route","maxRoundTripHours":"Optional number","maxDifficulty":"Optional integer 1–10","glacier":"Optional none or only","publicTransport":"Optional true","cursor":"Returned nextCursor for subsequent pages"},"instruction":"Apply constraints to the same route. Additional spatial/season filters are in the full schema."}},"nameInitialLinks":{"A":"https://peaks.fyi/directory?letter=A","B":"https://peaks.fyi/directory?letter=B","C":"https://peaks.fyi/directory?letter=C","D":"https://peaks.fyi/directory?letter=D","E":"https://peaks.fyi/directory?letter=E","F":"https://peaks.fyi/directory?letter=F","G":"https://peaks.fyi/directory?letter=G","H":"https://peaks.fyi/directory?letter=H","I":"https://peaks.fyi/directory?letter=I","J":"https://peaks.fyi/directory?letter=J","K":"https://peaks.fyi/directory?letter=K","L":"https://peaks.fyi/directory?letter=L","M":"https://peaks.fyi/directory?letter=M","N":"https://peaks.fyi/directory?letter=N","O":"https://peaks.fyi/directory?letter=O","P":"https://peaks.fyi/directory?letter=P","Q":"https://peaks.fyi/directory?letter=Q","R":"https://peaks.fyi/directory?letter=R","S":"https://peaks.fyi/directory?letter=S","T":"https://peaks.fyi/directory?letter=T","U":"https://peaks.fyi/directory?letter=U","V":"https://peaks.fyi/directory?letter=V","W":"https://peaks.fyi/directory?letter=W","X":"https://peaks.fyi/directory?letter=X","Y":"https://peaks.fyi/directory?letter=Y","Z":"https://peaks.fyi/directory?letter=Z"},"schemas":"https://peaks.fyi/api/agent","openapi":"https://peaks.fyi/api/agent/openapi.json","guide":"https://peaks.fyi/agents","linkOnlyBrowserFallback":"https://peaks.fyi/directory","limitations":"No bookings, payments, live rental stock, verified schedules or safe-to-climb verdict. Cite sources; preserve unknowns and research dates."},"guide":"https://peaks.fyi/agents","mcp":"https://peaks.fyi/mcp","openapi":"https://peaks.fyi/api/agent/openapi.json","authentication":"none","tools":[{"name":"get_route_briefs","description":"Compare up to six known routes in one compact evidence packet: grade, timing conflicts, selected equipment, linked huts, access, notices and optional dated daylight. Preserves per-route errors and source provenance. Partial results must not be treated as complete; no booking, live transport or suitability guarantee. Use get_route for full details and get_weather for forecasts.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_route_briefs?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_route_briefs","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"routes":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"routeId":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["slug","routeId"],"additionalProperties":false},"description":"One to six known peak slug / route ID pairs from search_routes; not free-text names."},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"sections":{"default":["equipment","huts","access","notices","daylight"],"maxItems":5,"type":"array","items":{"type":"string","enum":["equipment","huts","access","notices","daylight"]}}},"required":["routes"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"dataVersion":{"type":"string"},"complete":{"type":"boolean"},"requested":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"succeeded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"results":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"requested":{"type":"object","properties":{"slug":{"type":"string"},"routeId":{"type":"string"}},"required":["slug","routeId"],"additionalProperties":false},"status":{"type":"string","const":"ok"},"brief":{"type":"object","properties":{"canonicalId":{"type":"string"},"routeId":{"type":"string"},"sourceUpdatedAt":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}}},"required":["canonicalId","routeId","sourceUpdatedAt","sources","limitations"],"additionalProperties":{}}},"required":["requested","status","brief"],"additionalProperties":false},{"type":"object","properties":{"requested":{"type":"object","properties":{"slug":{"type":"string"},"routeId":{"type":"string"}},"required":["slug","routeId"],"additionalProperties":false},"status":{"type":"string","const":"error"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["requested","status","error"],"additionalProperties":false}]}}},"required":["dataVersion","complete","requested","succeeded","results"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_capabilities","description":"Inspect actual catalogue coverage, output JSON schemas, data version, units and unsupported operations before planning. Unknown data is not evidence of absence.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_capabilities?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_capabilities","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"dataVersion":{"type":"string"},"peakCount":{"type":"number"},"routeCount":{"type":"number"},"coverage":{"type":"object","properties":{},"additionalProperties":{}},"unsupported":{"type":"array","items":{"type":"string"}}},"required":["dataVersion","peakCount","routeCount","coverage","unsupported"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_notices","description":"Read dated notices with publication validity, explicit scope uncertainty and recurrence hints. Supply slug and the trip date; omitted date means today (UTC), echoed in requestedDate. Expired notices may describe recurring regulations; expiry is not evidence that access is open. Verify current law with the linked source.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_notices?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_notices","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak slug returned by search, for example mont-blanc."},"date":{"description":"Trip date, YYYY-MM-DD. Omit to check today's UTC date, which is echoed in requestedDate.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"routeId":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["slug"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"peakSlug":{"type":"string"},"requestedDate":{"type":"string"},"requestedRoute":{"type":["string","null"]},"notices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"text":{"type":"string"},"date":{"type":"string"},"sourceValidity":{"type":"string"},"recurrenceHint":{"type":"boolean"},"routeScope":{"type":"string"},"currentRuleConfirmed":{"type":"boolean","const":false}},"required":["id","text","date","sourceValidity","recurrenceHint","routeScope","currentRuleConfirmed"],"additionalProperties":{}}}},"required":["peakSlug","requestedDate","requestedRoute","notices"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"resolve_peak","description":"Resolve a canonical peak ID, external Wikidata/OSM ID, current slug or exact name to its current slug and citable URL. Example input: {\"id\":\"Ben Nevis\"}. Use canonical IDs to recover from renamed slugs.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/resolve_peak?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/resolve_peak","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":150,"description":"Canonical peak:id, Wikidata Q ID, OSM ID, current slug or exact translated name."}},"required":["id"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"canonicalId":{"type":"string"},"slug":{"type":"string"},"externalIds":{"type":"object","properties":{},"additionalProperties":{}},"revision":{"type":"string"},"url":{"type":"string"}},"required":["canonicalId","slug","externalIds","revision","url"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_changes","description":"Compare a watched set of peaks with a previous snapshot. Returns content changes, removals and an updated snapshot. No changes means no new source data, not proof that conditions are unchanged. Date-dependent notice status must still be checked.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_changes?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_changes","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slugs":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"previous":{"default":[],"maxItems":100,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":150},"revision":{"type":"string","maxLength":64}},"required":["id","revision"],"additionalProperties":false}}},"required":["slugs"],"additionalProperties":false,"description":"Poll an explicit watch list. Send the preceding snapshot to receive changed records and removals; an empty previous list establishes a baseline."},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"dataVersion":{"type":"string"},"changed":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}},"removed":{"type":"array","items":{"type":"string"}},"unchanged":{"type":"number"},"snapshot":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["dataVersion","changed","removed","unchanged","snapshot"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_daylight","description":"Compute sunrise, sunset and civil twilight for the exact calendar date and IANA zone. UTC instants handle daylight saving and polar days. Terrain and weather can reduce usable daylight.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_daylight?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_daylight","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak slug returned by search, for example mont-blanc."},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"timeZone":{"description":"Optional explicit IANA zone; defaults to the catalogue zone.","type":"string","maxLength":80}},"required":["slug","date"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"date":{"type":"string"},"timeZone":{"type":"string"},"sunrise":{"type":["string","null"]},"sunset":{"type":["string","null"]},"civilDawn":{"type":["string","null"]},"civilDusk":{"type":["string","null"]}},"required":["date","timeZone","sunrise","sunset","civilDawn","civilDusk"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"search","description":"Search peaks.fyi by mountain name, alternative name, country, range or climbing request. Returns citable peak IDs and URLs. Use fetch to read a result; use search_peaks for explicit filters and pagination. An empty result means no match in this catalogue, not that the mountain does not exist.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/search?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/search","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200,"description":"Peak name, alias, country, range, or request such as hiking in Austria in July."}},"required":["query"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"elevationM":{"type":"number"},"countries":{"type":"array","items":{"type":"string"}}},"required":["id","title","url","elevationM","countries"],"additionalProperties":{}}},"metadata":{"type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"dataVersion":{"type":"string"},"total":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"elevationM":{"type":"number"},"countries":{"type":"array","items":{"type":"string"}}},"required":["id","title","url","elevationM","countries"],"additionalProperties":{}}},"nextOffset":{"type":["number","null"]}},"required":["dataVersion","total","results","nextOffset"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},"required":["results","metadata"],"additionalProperties":false}},{"name":"fetch","description":"Read a peak search result by catalogue slug as a citable text document. Example input: {\"id\":\"ben-nevis\"}. This retrieves catalogue documents, not external website URLs; use your own browsing tool for publisher pages. Includes routes, season, access, hazards, huts, notices and provenance. Use get_weather for current forecasts.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/fetch?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/fetch","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak ID (slug) from search."}},"required":["id"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"url":{"type":"string"}},"required":["id","title","text","url"],"additionalProperties":false}},{"name":"get_peak","description":"Get compact peak facts and route IDs. Example input: {\"slug\":\"ben-nevis\"}. Optionally request access, huts, seasons, hazards or provenance sections. For fact questions search may already suffice. For current weather use get_weather; for hut booking information use get_huts. Research is not live availability.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_peak?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_peak","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak slug returned by search, for example mont-blanc."},"sections":{"description":"Omit for a compact overview, route IDs, season and notices. Request only sections needed.","maxItems":8,"type":"array","items":{"type":"string","enum":["overview","routes","seasons","access","huts","hazards","notices","provenance"]}}},"required":["slug"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"slug":{"type":"string"},"canonicalId":{"type":"string"},"name":{"type":"string"},"location":{"type":"array","items":{"type":"number"}},"timeZone":{"type":"string"},"revision":{"type":"string"}},"required":["slug","canonicalId","name","location","timeZone","revision"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_route","description":"Get one route by peak slug and routeId from get_peak: grade, equipment, key passages, stages, trailhead, timing, confidence and geometry QA. Failed, truncated or outline geometry must not be used for navigation. Times are estimates. No live route safety or opening guarantee.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_route?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_route","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak slug returned by search, for example mont-blanc."},"routeId":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Route ID from get_peak or search_routes."},"includeDescription":{"default":false,"type":"boolean"}},"required":["slug","routeId"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"id":{"type":"string"},"canonicalId":{"type":"string"},"name":{"type":"string"},"glacierTravel":{"type":["boolean","null"]},"timing":{"type":"object","properties":{"computed":{"type":"object","properties":{"ascentHours":{"type":"number"},"descentHours":{"type":"number"},"roundTripHours":{"type":"number"}},"required":["ascentHours","descentHours","roundTripHours"],"additionalProperties":{}},"published":{"anyOf":[{"type":"object","properties":{},"additionalProperties":{}},{"type":"null"}]},"preferredEstimate":{"type":"null"}},"required":["computed","published","preferredEstimate"],"additionalProperties":{}},"geometry":{"type":"object","properties":{"status":{"type":"string"},"navigationSuitable":{"type":"boolean"},"warning":{"type":["string","null"]}},"required":["status","navigationSuitable","warning"],"additionalProperties":{}},"peakSlug":{"type":"string"},"trailhead":{"type":"object","properties":{},"additionalProperties":{}},"stages":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}},"equipment":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}},"gpxUrl":{"type":["string","null"]},"gpxScope":{"type":"string","enum":["round-trip","ascent-only"]}},"required":["id","canonicalId","name","glacierTravel","timing","geometry","peakSlug","trailhead","stages","equipment","gpxUrl","gpxScope"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_route_point","description":"Look up a named waypoint or difficult passage on a route. Returns source notes, known coordinates, nearby stage names, key passages and relevant equipment. Missing coordinates or conditions remain unknown; this is not live navigation guidance.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_route_point?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_route_point","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak slug returned by search, for example mont-blanc."},"routeId":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"query":{"type":"string","minLength":1,"maxLength":150,"description":"Name of a waypoint or key passage, e.g. Grand Couloir or halfway lochan."}},"required":["slug","routeId","query"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"peakSlug":{"type":"string"},"routeId":{"type":"string"},"query":{"type":"string"},"waypoints":{"type":"array","items":{"type":"object","properties":{},"additionalProperties":{}}}},"required":["peakSlug","routeId","query","waypoints"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_huts","description":"Read huts, documented seasonal operation, source years and booking/contact URLs for a peak. Beds means capacity, never vacancies. Live availability, reservations, rental inventory and current opening status are unknown. Do not infer next year's opening dates from a dated season; contact the linked provider.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_huts?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_huts","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak slug returned by search, for example mont-blanc."},"hutId":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"date":{"description":"Planning date; does not turn published seasons into live availability.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["slug"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"peakSlug":{"type":"string"},"requestedDate":{"type":["string","null"]},"huts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"capacityBeds":{"type":["number","null"]},"sourceYears":{"type":"array","items":{"type":"string"}},"bookingInformationUrl":{"type":["string","null"]},"availability":{"type":"object","properties":{"status":{"type":"string","const":"unknown"},"reason":{"type":"string"}},"required":["status","reason"],"additionalProperties":false},"rentalEquipmentAvailability":{"type":"object","properties":{"status":{"type":"string","const":"unknown"}},"required":["status"],"additionalProperties":false}},"required":["id","name","capacityBeds","sourceYears","bookingInformationUrl","availability","rentalEquipmentAvailability"],"additionalProperties":{}}}},"required":["peakSlug","requestedDate","huts"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"search_routes","description":"Find routes satisfying all supplied constraints on the SAME route, including difficulty, glacier travel, style and computed round-trip hours. Unknown glacier status is excluded by glacier filters. Searches all candidate peaks; use nextCursor until null for complete results. Coordinates filter peak locations, not trailheads. Transport matches documented prose, not confirmed operation. Historical season and public transport descriptions are not current operating confirmations. Read route details and conflicts before recommending.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/search_routes?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/search_routes","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"near":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":20000}},"required":["latitude","longitude","radiusKm"],"additionalProperties":false},"bbox":{"description":"Exactly [west,south,east,north] in degrees; west > east crosses the antimeridian.","minItems":4,"maxItems":4,"type":"array","items":{"type":"number","minimum":-180,"maximum":180}},"query":{"default":"","type":"string","maxLength":200},"cursor":{"description":"Opaque nextCursor from the same query. Bound to the catalogue revision and filters.","type":"string","maxLength":500},"countries":{"maxItems":8,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"month":{"type":"integer","minimum":1,"maximum":12},"maxDifficulty":{"type":"integer","minimum":1,"maximum":10},"maxRoundTripHours":{"type":"number","exclusiveMinimum":0,"maximum":100},"glacier":{"type":"string","enum":["none","only"]},"styles":{"maxItems":7,"type":"array","items":{"type":"string","enum":["hike","scramble","via_ferrata","glacier","rock","mixed","ski"]}},"publicTransport":{"description":"Require documented transport to the trailhead; schedules and operating dates still need checking.","type":"boolean"},"limit":{"default":10,"type":"integer","minimum":1,"maximum":20}},"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"dataVersion":{"type":"string"},"total":{"type":"number"},"routes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"canonicalId":{"type":"string"},"name":{"type":"string"},"glacierTravel":{"type":["boolean","null"]},"timing":{"type":"object","properties":{"computed":{"type":"object","properties":{"ascentHours":{"type":"number"},"descentHours":{"type":"number"},"roundTripHours":{"type":"number"}},"required":["ascentHours","descentHours","roundTripHours"],"additionalProperties":{}},"published":{"anyOf":[{"type":"object","properties":{},"additionalProperties":{}},{"type":"null"}]},"preferredEstimate":{"type":"null"}},"required":["computed","published","preferredEstimate"],"additionalProperties":{}},"geometry":{"type":"object","properties":{"status":{"type":"string"},"navigationSuitable":{"type":"boolean"},"warning":{"type":["string","null"]}},"required":["status","navigationSuitable","warning"],"additionalProperties":{}}},"required":["id","canonicalId","name","glacierTravel","timing","geometry"],"additionalProperties":{}}},"nextCursor":{"type":["string","null"]},"complete":{"type":"boolean"},"coverage":{"type":"object","properties":{},"additionalProperties":{}}},"required":["dataVersion","total","routes","nextCursor","complete","coverage"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"get_weather","description":"Get published weather for a peak and optional summit/hut/trailhead target. Set targetId and start/end for a bounded planning response; unfiltered forecasts can be large. Point samples are separate from accumulated rain/snow intervals and complete-window totals. Check target coverage and missing fields. Stale is marked; expired, missing and far-future data is unavailable. For a trip months away use get_peak seasons instead, never invent a forecast or a safety verdict.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/get_weather?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/get_weather","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"slug":{"type":"string","maxLength":100,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","description":"Peak slug returned by search, for example mont-blanc."},"view":{"default":"full","description":"Compact retains requested weather, intervals, uncertainty and coverage, omitting auxiliary per-point fields. Follow fullData for all fields.","type":"string","enum":["full","compact"]},"start":{"description":"Inclusive forecast interval start, ISO 8601 with time zone.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"end":{"description":"Exclusive forecast interval end, ISO 8601 with time zone.","type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"targetId":{"description":"Optional exact summit, hut or trailhead target ID. Omit to see all targets.","type":"string","maxLength":200}},"required":["slug"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"status":{"type":"string"}},"required":["status"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}},{"name":"search_peaks","description":"Find and compare mountains with explicit country, elevation, season, difficulty and glacier filters. All filters are hard constraints; never silently relaxed. Returns compact peak summaries, IDs, total and nextOffset. Read get_peak and get_route before recommending a route: peak-level filters can describe different routes.","method":"POST","methods":["GET","POST"],"getUrl":"https://peaks.fyi/api/agent/search_peaks?input=<URL-encoded JSON object>","url":"https://peaks.fyi/api/agent/search_peaks","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200,"description":"Peak name, alias, country, range, or request such as hiking in Austria in July."},"near":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":20000}},"required":["latitude","longitude","radiusKm"],"additionalProperties":false},"bbox":{"description":"Exactly [west,south,east,north] in degrees; west > east crosses the antimeridian.","minItems":4,"maxItems":4,"type":"array","items":{"type":"number","minimum":-180,"maximum":180}},"countries":{"maxItems":8,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"month":{"description":"Month with a good historical climbing season; not a weather forecast.","type":"integer","minimum":1,"maximum":12},"minElevationM":{"type":"number","minimum":0,"maximum":9000},"maxElevationM":{"type":"number","minimum":0,"maximum":9000},"maxDifficulty":{"description":"1–2 easy hike, 3 mountain hike, 4 alpine hike/F, 5 PD, 6 AD, 7 D, 8 TD, 9 ED, 10 extreme. Peak-level minimum, not a guarantee for every route.","type":"integer","minimum":1,"maximum":10},"glacier":{"type":"string","enum":["none","only"]},"limit":{"default":10,"description":"Page size, at most 20. Omit for 10. Use nextOffset to request another page.","type":"integer","minimum":1,"maximum":20},"offset":{"default":0,"description":"Start at 0; use nextOffset from the preceding response for subsequent pages.","type":"integer","minimum":0,"maximum":100000}},"required":["query"],"additionalProperties":false},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"schemaVersion":{"type":"number","const":1},"retrievedAt":{"type":"string"},"data":{"type":"object","properties":{"dataVersion":{"type":"string"},"total":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"elevationM":{"type":"number"},"countries":{"type":"array","items":{"type":"string"}}},"required":["id","title","url","elevationM","countries"],"additionalProperties":{}}},"nextOffset":{"type":["number","null"]}},"required":["dataVersion","total","results","nextOffset"],"additionalProperties":{}},"sources":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","retrievedAt","data","sources"],"additionalProperties":false}}]}