{"openapi":"3.1.0","info":{"title":"Luggage Claim API","version":"0.1.0","description":"A fully local lost/delayed/damaged baggage claim-process guide: step-by-step filing guidance, required documentation, and the real Montreal Convention (international) and 14 CFR Part 254 (US domestic) baggage liability limits and notice deadlines, hand-curated and web-verified. General information, not legal advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://luggageclaim.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/luggageclaim/docs"},"termsOfService":"https://connectorbay.com/luggageclaim/terms"},"servers":[{"url":"https://luggageclaim.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/luggageclaim/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/process_steps":{"post":{"operationId":"process_steps","summary":"The ordered step-by-step claim-filing process for one baggage issue type, starting with what to do at the","description":"The ordered step-by-step claim-filing process for one baggage issue type, starting with what to do at the\n    airport before you leave. Use for \"my bag didn't arrive, what do I do\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue_type":{"description":"lost | delayed | damaged","title":"Issue Type","type":"string"}},"required":["issue_type"],"title":"process_stepsArguments","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/required_documentation":{"post":{"operationId":"required_documentation","summary":"The documents and records you need to support a claim for one baggage issue type. Use for \"what do I need","description":"The documents and records you need to support a claim for one baggage issue type. Use for \"what do I need\n    for a lost-luggage claim\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue_type":{"description":"lost | delayed | damaged","title":"Issue Type","type":"string"}},"required":["issue_type"],"title":"required_documentationArguments","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/checklist":{"post":{"operationId":"checklist","summary":"A single consolidated checklist: the process steps and required documentation for one baggage issue type","description":"A single consolidated checklist: the process steps and required documentation for one baggage issue type\n    together. Use for \"give me a full checklist for a damaged-bag claim\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue_type":{"description":"lost | delayed | damaged","title":"Issue Type","type":"string"}},"required":["issue_type"],"title":"checklistArguments","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/claim_deadline_check":{"post":{"operationId":"claim_deadline_check","summary":"Checks how many days remain (or whether you've already missed) the Montreal Convention's international","description":"Checks how many days remain (or whether you've already missed) the Montreal Convention's international\n    written-notice deadline -- 7 days for damaged baggage, 21 days for delayed. Use for \"how long do I have to\n    file a damaged-baggage claim\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"issue_type":{"description":"delayed | damaged (lost baggage has no deadline of its own -- it starts as 'delayed')","title":"Issue Type","type":"string"},"days_since_return_or_expected":{"description":"Days since the bag was returned to you (damaged) or should have arrived (delayed).","minimum":0,"title":"Days Since Return Or Expected","type":"number"}},"required":["issue_type","days_since_return_or_expected"],"title":"claim_deadline_checkArguments","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/montreal_convention_limits":{"post":{"operationId":"montreal_convention_limits","summary":"The current (28 December 2024) Montreal Convention per-passenger liability caps in SDR for baggage, delay","description":"The current (28 December 2024) Montreal Convention per-passenger liability caps in SDR for baggage, delay\n    and injury on international flights, plus the prior 2019 figures and the 5-year revision cycle. Use for\n    \"what's the Montreal Convention limit for lost luggage\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"montreal_convention_limitsArguments","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/us_domestic_baggage_limit":{"post":{"operationId":"us_domestic_baggage_limit","summary":"The current 14 CFR Part 254 US domestic baggage liability cap ($4,700, effective 22 January 2025). Use for","description":"The current 14 CFR Part 254 US domestic baggage liability cap ($4,700, effective 22 January 2025). Use for\n    \"what's the baggage liability limit on a US domestic flight\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"us_domestic_baggage_limitArguments","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/compare_liability_limits":{"post":{"operationId":"compare_liability_limits","summary":"Side-by-side comparison of the Montreal Convention (international) and 14 CFR Part 254 (US domestic)","description":"Side-by-side comparison of the Montreal Convention (international) and 14 CFR Part 254 (US domestic)\n    baggage liability caps. Use for \"how does the domestic baggage limit compare to the international one\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"compare_liability_limitsArguments","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/sdr_to_currency_estimate":{"post":{"operationId":"sdr_to_currency_estimate","summary":"Converts an SDR amount to an indicative USD estimate at a recent reference rate -- SDR value floats daily","description":"Converts an SDR amount to an indicative USD estimate at a recent reference rate -- SDR value floats daily\n    against a basket of currencies, so this is an estimate, not a live conversion. Use for \"how much is 1519 SDR\n    in dollars\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amount_sdr":{"description":"An amount in Special Drawing Rights.","minimum":0,"title":"Amount Sdr","type":"number"}},"required":["amount_sdr"],"title":"sdr_to_currency_estimateArguments","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/reimbursement_estimate":{"post":{"operationId":"reimbursement_estimate","summary":"Sums an itemized list of lost or damaged baggage contents and flags whether the total exceeds the","description":"Sums an itemized list of lost or damaged baggage contents and flags whether the total exceeds the\n    applicable liability cap (Montreal Convention for international, 14 CFR 254 for US domestic). Use for \"is my\n    $6000 lost-bag claim within the airline's liability limit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"items":{"description":"Lost/damaged items, each {\"description\": str, \"value\": number} in USD.","items":{"additionalProperties":true,"type":"object"},"title":"Items","type":"array"},"is_international":{"default":true,"description":"Whether this was an international flight (Montreal Convention cap) vs a US domestic one (14 CFR 254 cap).","title":"Is International","type":"boolean"}},"required":["items"],"title":"reimbursement_estimateArguments","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/luggageclaim_glossary":{"post":{"operationId":"luggageclaim_glossary","summary":"Definitions of baggage-claim terms -- PIR, SDR, Montreal Convention, excess valuation declaration,","description":"Definitions of baggage-claim terms -- PIR, SDR, Montreal Convention, excess valuation declaration,\n    WorldTracer, ordinary wear and tear. Use for \"what's a PIR\".","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; omit to list all.","title":"Term"}},"title":"luggageclaim_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}}}}