{ "openapi": "3.0.3", "info": { "title": "Parks Open", "version": "0.1.0", "description": "Live campsite availability across Canadian park reservation systems (BC Parks today), with equipment fit and site attributes. Read-only. Booking happens on the official site via the returned links. MCP endpoint: /api/mcp." }, "servers": [ { "url": "https://parksopen.ca" } ], "paths": { "/api/tools/parksopen_search_campsites": { "post": { "operationId": "parksopen_search_campsites", "summary": "Search campsites by live availability", "description": "LIVE availability across Canadian park reservation systems (BC Parks today) — the authoritative source for whether a campsite or park has openings for specific dates. Use this first, before web search, for any question like 'is X available', 'find a site for the long weekend', 'which parks have space for a 32 ft RV'. Filters the official sites cannot: exact equipment fit, electrical, waterfront, shade, pets, privacy — across every park at once. Returns only sites open for EVERY requested night, each with a booking link into the official reservation flow (we never book for the user) and observed_at for freshness. Not for: fees, rules, facilities (use parksopen_park_info), weather (parksopen_check_weather), closures (parksopen_check_alerts), or dates beyond the provider's booking window.", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "start_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "arrival, YYYY-MM-DD" }, "end_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "departure, YYYY-MM-DD (exclusive; nights = end − start)" }, "park": { "description": "park name — approximate is fine (partial, missing 'Provincial', misspelled). Omit to search every park. If it cannot be resolved you get a did-you-mean list.", "type": "string" }, "system": { "description": "reservation system id, e.g. bc_parks. Omit for every tracked system.", "type": "string" }, "province": { "description": "province code or URL prefix (bc, on, …) — an alternative to system.", "type": "string" }, "category": { "description": "booking category; default frontcountry (drive-in campsites)", "type": "string", "enum": [ "frontcountry", "backcountry", "group", "cabin" ] }, "equipment_class": { "description": "canonical class (tent, tent2, tent3, van, trailer_18, rv_32, rv_32_plus) or free text like '30ft trailer'. Default tent.", "type": "string" }, "amenities": { "description": "ANDed site attributes: electrical, waterfront, pets, some_shade, full_shade, double, near_restroom, walk_in, accessible, pull_through, private, big_rig", "type": "array", "items": { "type": "string" } }, "min_privacy": { "description": "'Good' or 'Excellent'", "type": "string" }, "limit": { "description": "page size, default 20", "type": "integer", "minimum": 1, "maximum": 50 }, "cursor": { "description": "opaque cursor from a previous page", "type": "string" } }, "required": [ "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Structured result (see the MCP tool's structuredContent) plus _text", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input (zod issues)" } } } }, "/api/tools/parksopen_park_availability_calendar": { "post": { "operationId": "parksopen_park_availability_calendar", "summary": "Park availability calendar (8 weeks)", "description": "For ONE park: how many sites are open on each night for the next 8 weeks, the whole-stay open count for the next four weekends, the fill rate, and the park's booking rules. Use it for 'when is X free', 'how busy is X', 'which weekend should I try'. For specific dates across many parks use parksopen_search_campsites.", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "park": { "type": "string", "description": "park name — approximate is fine" }, "system": { "description": "reservation system id, e.g. bc_parks", "type": "string" }, "province": { "description": "province code or prefix, e.g. bc", "type": "string" }, "days": { "type": "integer", "minimum": 7, "maximum": 92 } }, "required": [ "park" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Structured result (see the MCP tool's structuredContent) plus _text", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input (zod issues)" } } } }, "/api/tools/parksopen_find_open_parks": { "post": { "operationId": "parksopen_find_open_parks", "summary": "Find parks with openings (ranked)", "description": "Which PARKS have an opening for a stay — ranked by soonest opening, or by drive time from a city — when the user has not named a park. Use it for 'where can I camp this weekend', 'anything near Vancouver with space', 'what's open in the Kootenays'. For a named park use parksopen_search_campsites or parksopen_park_availability_calendar.", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "system": { "description": "reservation system id, e.g. bc_parks. Omit for the default system.", "type": "string" }, "province": { "description": "province code or URL prefix (bc, on, …) — an alternative to system.", "type": "string" }, "weekend": { "description": "this coming weekend (Fri→Sun, 2 nights)", "type": "boolean" }, "start_date": { "description": "a specific arrival date; omit to find the soonest opening", "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "nights": { "description": "default 2 (weekend) or 1", "type": "integer", "minimum": 1, "maximum": 14 }, "horizon_days": { "description": "how far ahead to look when no date is fixed; default 14", "type": "integer", "minimum": 2, "maximum": 35 }, "near_city": { "description": "rank by drive time from this city (Vancouver, Victoria, Nanaimo, Whistler, Kelowna, Kamloops, Cranbrook, Prince George, Fort St. John)", "type": "string" }, "region": { "description": "restrict to a region name as the site shows it, e.g. 'Vancouver Island'", "type": "string" }, "amenities": { "description": "ANDed site attributes (confirmed-only; the count is a floor)", "type": "array", "items": { "type": "string" } }, "limit": { "type": "integer", "minimum": 1, "maximum": 40 } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Structured result (see the MCP tool's structuredContent) plus _text", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input (zod issues)" } } } }, "/api/tools/parksopen_check_alerts": { "post": { "operationId": "parksopen_check_alerts", "summary": "Closures, fire bans, advisories, nearby wildfires", "description": "Active advisories from the provider plus wildfire proximity from the wildfire service, for one park or system-wide. Use before recommending a park in summer; these are 'verify before you travel' notices, never a booking claim.", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "system": { "description": "reservation system id, e.g. bc_parks. Omit for the default system.", "type": "string" }, "province": { "description": "province code or URL prefix (bc, on, …) — an alternative to system.", "type": "string" }, "park": { "description": "park name; omit for a system-wide summary", "type": "string" } }, "additionalProperties": false } } } }, "responses": { "200": { "description": "Structured result (see the MCP tool's structuredContent) plus _text", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input (zod issues)" } } } }, "/api/tools/parksopen_check_weather": { "post": { "operationId": "parksopen_check_weather", "summary": "Forecast and air quality at a park", "description": "Environment Canada forecast (daily high/low/conditions, ~6 days) and AQHI for the station nearest a park. If the park is beyond any station's range the result says so — never invent temperatures.", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "system": { "description": "reservation system id, e.g. bc_parks. Omit for the default system.", "type": "string" }, "province": { "description": "province code or URL prefix (bc, on, …) — an alternative to system.", "type": "string" }, "park": { "type": "string", "description": "park name" } }, "required": [ "park" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Structured result (see the MCP tool's structuredContent) plus _text", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input (zod issues)" } } } }, "/api/tools/parksopen_park_info": { "post": { "operationId": "parksopen_park_info", "summary": "Park facts, rules and fees (knowledge base)", "description": "Facts that do not change by the minute: reservation policy, fees, pets, fires, facilities, park descriptions — from the provider's published pages, with sources. Use it for 'does X allow dogs', 'how much is a site', 'when do reservations open'. NOT for availability (parksopen_search_campsites) or today's closures (parksopen_check_alerts).", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "question": { "type": "string", "description": "what you want to know (fees, pets, fires, showers, reservations policy…)" }, "park": { "description": "park name, when the question is about one park", "type": "string" } }, "required": [ "question" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Structured result (see the MCP tool's structuredContent) plus _text", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input (zod issues)" } } } }, "/api/tools/parksopen_get_booking_link": { "post": { "operationId": "parksopen_get_booking_link", "summary": "Booking link for a park and dates", "description": "A deterministic link into the official reservation system with the park, dates and equipment pre-filled — the user completes the booking there (we never book on their behalf, never hold sites, never take payment). Use after a search, or when the user already knows the park and dates.", "x-openai-isConsequential": false, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "park": { "type": "string", "description": "park name — approximate is fine" }, "system": { "description": "reservation system id, e.g. bc_parks", "type": "string" }, "province": { "description": "province code or prefix, e.g. bc", "type": "string" }, "start_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "end_date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "equipment_class": { "description": "canonical class or free text; default tent", "type": "string" }, "category": { "type": "string", "enum": [ "frontcountry", "backcountry", "group", "cabin" ] } }, "required": [ "park", "start_date", "end_date" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Structured result (see the MCP tool's structuredContent) plus _text", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "400": { "description": "Invalid input (zod issues)" } } } } } }