{"openapi":"3.1.0","info":{"title":"WarrantyClaim API","version":"0.1.0","description":"A fully local electronics warranty-claim process guide: the general anatomy of a claim, a claim-preparation checklist, a general consumer-protection/Magnuson-Moss Warranty Act reference, a failure-risk reference by device category, and a real extended-warranty expected-value calculator. General educational information only, not legal advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://warrantyclaim.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/warrantyclaim/docs"},"termsOfService":"https://connectorbay.com/warrantyclaim/terms"},"servers":[{"url":"https://warrantyclaim.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/warrantyclaim/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/claim_anatomy":{"post":{"operationId":"claim_anatomy","summary":"The general anatomy of a warranty claim: proof-of-purchase requirements, what's typically covered","description":"The general anatomy of a warranty claim: proof-of-purchase requirements, what's typically covered\n    (manufacturing defects) vs typically excluded (accidental damage, water damage, absent separate coverage),\n    and warranty duration/who to contact. Use for \"is water damage covered under warranty\", \"what do I need to\n    make a warranty claim\". General patterns only — always check the specific written warranty.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"proof of purchase, typically covered, typically excluded, or warranty duration and who to contact. Omit to list all.","examples":["typically excluded","proof of purchase"],"title":"Topic"}},"title":"claim_anatomyArguments","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_preparation_checklist":{"post":{"operationId":"claim_preparation_checklist","summary":"An actionable, step-by-step checklist for preparing a warranty claim: proof of purchase, model/serial","description":"An actionable, step-by-step checklist for preparing a warranty claim: proof of purchase, model/serial\n    number, checking warranty status, documenting the defect, backing up data, understanding the claim process,\n    keeping packaging, and tracking the claim/case number. Use for \"what do I need before I file a warranty\n    claim\", \"how do I prepare to send my laptop in for repair\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"claim_preparation_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/consumer_rights_reference":{"post":{"operationId":"consumer_rights_reference","summary":"General, high-level consumer-protection concepts relevant to warranties — the US Magnuson-Moss","description":"General, high-level consumer-protection concepts relevant to warranties — the US Magnuson-Moss\n    Warranty Act's real general provisions, implied warranties of merchantability, and state-level protections.\n    Use for \"what are my rights under warranty law\", \"can a company void my warranty for using off-brand parts\".\n    General education, NOT legal advice — consult an attorney or your state's consumer-protection office for\n    a specific dispute.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"magnuson-moss warranty act, implied warranties, or state-level protections. Omit to list all.","examples":["magnuson-moss warranty act","implied warranties"],"title":"Topic"}},"title":"consumer_rights_referenceArguments","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/failure_risk_reference":{"post":{"operationId":"failure_risk_reference","summary":"Commonly-cited general failure-rate planning figures by device category, for use as a rough input to","description":"Commonly-cited general failure-rate planning figures by device category, for use as a rough input to\n    extended_warranty_value_calculator when you don't have your own estimate. Use for \"what's a reasonable\n    failure rate to assume for a laptop\". General planning figures only, not a prediction for any specific unit.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"device_category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"smartphone, laptop, major appliance, or tv. Omit to list all.","examples":["smartphone","laptop"],"title":"Device Category"}},"title":"failure_risk_referenceArguments","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/extended_warranty_value_calculator":{"post":{"operationId":"extended_warranty_value_calculator","summary":"A real expected-value cost-benefit calculation: expected cost without the warranty = failure_probability","description":"A real expected-value cost-benefit calculation: expected cost without the warranty = failure_probability\n    x repair_cost_if_fails; compares that to the warranty's price to say whether buying is favored in strict\n    expected-value terms, plus the break-even failure probability. Use for \"is a $40 extended warranty worth it\n    for a $300 device with a 15% chance of failing\". Real math from the numbers given; the probability and\n    repair cost you provide are estimates you supply, not looked up for your specific product.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"warranty_cost":{"description":"Price of the extended warranty / protection plan.","exclusiveMinimum":0,"title":"Warranty Cost","type":"number"},"failure_probability":{"description":"Estimated probability the device fails and needs a paid repair within the coverage period, as a fraction (0.2 = 20%).","maximum":1,"minimum":0,"title":"Failure Probability","type":"number"},"repair_cost_if_fails":{"description":"Estimated out-of-pocket cost to repair or replace the device if it fails.","exclusiveMinimum":0,"title":"Repair Cost If Fails","type":"number"}},"required":["warranty_cost","failure_probability","repair_cost_if_fails"],"title":"extended_warranty_value_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}}}}