{"openapi":"3.1.0","info":{"title":"Camino (The Way) API","version":"0.1.0","description":"A fully local Camino de Santiago pilgrimage-planning reference and calculator: verified route distances and character, a stage planner and distance-remaining calculator, albergue and credencial/Compostela guidance, a Camino-specific packing list, a route comparison table, history/UNESCO status, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://camino.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/camino/docs"},"termsOfService":"https://connectorbay.com/camino/terms"},"servers":[{"url":"https://camino.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/camino/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/route_info":{"post":{"operationId":"route_info","summary":"One major Camino route's typical starting point, verified total distance, terrain and difficulty","description":"One major Camino route's typical starting point, verified total distance, terrain and difficulty\n    character, popularity/crowd level, and a short historical note. Use for \"how far is the Camino Francés\",\n    \"tell me about the Camino Primitivo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"route_name":{"description":"A major Camino route's name, English name, or common alias.","examples":["Camino Francés","Camino Portugués","Camino del Norte","Camino Primitivo","Vía de la Plata"],"title":"Route Name","type":"string"}},"required":["route_name"],"title":"route_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/stage_planner":{"post":{"operationId":"stage_planner","summary":"Computes the number of walking days needed to cover a named route's verified total distance at a target","description":"Computes the number of walking days needed to cover a named route's verified total distance at a target\n    daily pace (rounded up, since a partial day still means walking), plus a sensible rest-day suggestion and the\n    resulting total trip length. Genuine arithmetic over the route's verified distance, not a lookup. Use for\n    \"how many days to walk the Camino Francés at 25km a day\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"route_name":{"description":"A major Camino route's name, English name, or common alias.","title":"Route Name","type":"string"},"daily_km_target":{"description":"Target walking distance per day, in kilometers.","exclusiveMinimum":0,"maximum":80,"title":"Daily Km Target","type":"number"}},"required":["route_name","daily_km_target"],"title":"stage_plannerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/distance_calculator":{"post":{"operationId":"distance_calculator","summary":"Given how far someone has already walked on a named route, computes the remaining distance and percent","description":"Given how far someone has already walked on a named route, computes the remaining distance and percent\n    complete, and — if a daily target is given — the estimated walking days remaining. Use for \"I've walked\n    300km of the Camino del Norte, how much is left\", \"at 22km a day, how many days until Santiago\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"route_name":{"description":"A major Camino route's name, English name, or common alias.","title":"Route Name","type":"string"},"km_completed":{"description":"How far along the route has already been walked, in kilometers.","minimum":0,"title":"Km Completed","type":"number"},"daily_km_target":{"anyOf":[{"exclusiveMinimum":0,"maximum":80,"type":"number"},{"type":"null"}],"default":null,"description":"Optional target daily pace, to also estimate days remaining.","title":"Daily Km Target"}},"required":["route_name","km_completed"],"title":"distance_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/albergue_guide":{"post":{"operationId":"albergue_guide","summary":"General guidance on pilgrim hostels (albergues): public/municipal vs. private vs. parish/donativo vs.","description":"General guidance on pilgrim hostels (albergues): public/municipal vs. private vs. parish/donativo vs.\n    associational, typical cost tiers, first-come-first-served booking norms, and the communal, dorm-style\n    experience. Use for \"what's an albergue\", \"do I need to book ahead\", \"how much does a pilgrim hostel cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"albergue_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/credencial_info":{"post":{"operationId":"credencial_info","summary":"The pilgrim's passport (credencial) and how sellos (stamps) work, the verified minimum-distance rules for","description":"The pilgrim's passport (credencial) and how sellos (stamps) work, the verified minimum-distance rules for\n    a Compostela (100 km on foot/horseback or 200 km by bicycle, ending in Santiago de Compostela), and the\n    Compostela vs. Certificado de Bienvenida vs. Certificado de Distancia distinction — based on a pilgrim's own\n    stated motivation, with no motivation presented as more legitimate than another. Use for \"how do I get a\n    Compostela\", \"how many stamps do I need\", \"what's the minimum distance to get a certificate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"credencial_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/packing_list":{"post":{"operationId":"packing_list","summary":"Camino-specific packing guidance: broken-in footwear, blister prevention and care, layered clothing for","description":"Camino-specific packing guidance: broken-in footwear, blister prevention and care, layered clothing for\n    variable weather, and pack-weight discipline for consecutive multi-week walking days — distinct in scope from\n    general airline/travel packing (see the separate Packlist connector for that). Use for \"what should I pack\n    for the Camino de Santiago\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"packing_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/route_comparison":{"post":{"operationId":"route_comparison","summary":"A side-by-side comparison of the major Camino routes: distance, typical duration, difficulty, popularity","description":"A side-by-side comparison of the major Camino routes: distance, typical duration, difficulty, popularity\n    and terrain, all in one table. Use for \"compare the Camino routes\", \"which Camino route is easiest\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"route_comparisonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/history_overview":{"post":{"operationId":"history_overview","summary":"The Camino de Santiago's origin (the tradition of St. James's remains at Santiago de Compostela), its","description":"The Camino de Santiago's origin (the tradition of St. James's remains at Santiago de Compostela), its\n    medieval peak and later decline, its 20th-century revival, and its UNESCO World Heritage status — presented\n    as the historical and cultural phenomenon it is, with no religious advocacy either way. Use for \"why do\n    people walk the Camino de Santiago\", \"is the Camino a UNESCO site\", \"what's the history of the Camino\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"history_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/camino_glossary":{"post":{"operationId":"camino_glossary","summary":"Definitions of common Camino terms: credencial, sello, albergue, peregrino, Compostela, buen camino,","description":"Definitions of common Camino terms: credencial, sello, albergue, peregrino, Compostela, buen camino,\n    etapa, mochila, donativo, vieira, flecha amarilla, hospitalero. Use for \"what does buen camino mean\", \"what's\n    a sello\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up (e.g. 'sello', 'albergue', 'buen camino'); omit to list all.","title":"Term"}},"title":"camino_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}