{"openapi":"3.1.0","info":{"title":"AppLifecycle API","version":"0.1.0","description":"A fully local device-upgrade/e-waste responsible-disposal toolkit: a real replacement-timing decision matrix, a repair-vs-replace '50% rule' cost calculator, e-waste disposal guidance, and device-longevity tips by device type.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://applifecycle.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/applifecycle/docs"},"termsOfService":"https://connectorbay.com/applifecycle/terms"},"servers":[{"url":"https://applifecycle.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/applifecycle/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/replacement_timing_recommendation":{"post":{"operationId":"replacement_timing_recommendation","summary":"Recommends whether to keep, repair, monitor, or replace a device, using a real decision matrix that","description":"Recommends whether to keep, repair, monitor, or replace a device, using a real decision matrix that\n    crosses the device's age (as a ratio of that device type's documented typical lifespan) against your\n    satisfaction rating — not a blanket \"buy new\": five of the matrix's nine outcomes are keep/monitor/repair.\n    Attaches device-specific repair suggestions whenever the answer isn't a clean \"keep\". Use for \"should I\n    replace my 4 year old laptop\", \"is it worth fixing my smart TV\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"device_type":{"description":"smartphone | laptop | desktop | tablet | smart_tv | smartwatch | router | gaming_console | printer | camera","title":"Device Type","type":"string"},"age_years":{"description":"How old the device is, in years.","maximum":40,"minimum":0,"title":"Age Years","type":"number"},"performance_satisfaction":{"description":"How satisfied you are with its current performance: 1 (very unhappy) to 5 (very happy).","maximum":5,"minimum":1,"title":"Performance Satisfaction","type":"integer"}},"required":["device_type","age_years","performance_satisfaction"],"title":"replacement_timing_recommendationArguments","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/repair_vs_replace_cost_check":{"post":{"operationId":"repair_vs_replace_cost_check","summary":"Applies the widely cited '50% rule': once a repair costs roughly half or more of a comparable new","description":"Applies the widely cited '50% rule': once a repair costs roughly half or more of a comparable new\n    device's price, replacing is generally the better value; below that, repairing usually is. Give either an\n    exact new_device_cost_usd or a device_type to use a typical reference price. Use for \"is it worth paying $300\n    to fix my laptop\", \"should I repair or replace this printer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"repair_cost_usd":{"description":"What the repair would cost, in USD.","minimum":0,"title":"Repair Cost Usd","type":"number"},"device_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional device type, used to look up a typical reference new-device price if new_device_cost_usd is omitted.","title":"Device Type"},"new_device_cost_usd":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"What a comparable new device costs, in USD. If omitted, a typical reference price for device_type is used instead.","title":"New Device Cost Usd"}},"required":["repair_cost_usd"],"title":"repair_vs_replace_cost_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/e_waste_disposal_guidance":{"post":{"operationId":"e_waste_disposal_guidance","summary":"Responsible e-waste disposal guidance for one device type: why not to trash electronics, the take-back/","description":"Responsible e-waste disposal guidance for one device type: why not to trash electronics, the take-back/\n    trade-in program concept, certified e-waste recycler standards (R2, e-Stewards) and what they mean, and a\n    reminder to properly wipe data first. Use for \"how do I responsibly get rid of an old phone\", \"what's the R2\n    e-waste certification\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"device_type":{"description":"smartphone | laptop | desktop | tablet | smart_tv | smartwatch | router | gaming_console | printer | camera","title":"Device Type","type":"string"}},"required":["device_type"],"title":"e_waste_disposal_guidanceArguments","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/device_longevity_tips":{"post":{"operationId":"device_longevity_tips","summary":"Practical, device-type-specific tips for extending a device's useful life — battery care, thermal","description":"Practical, device-type-specific tips for extending a device's useful life — battery care, thermal\n    management, storage habits, and more. Use for \"how do I make my phone battery last longer\", \"how do I extend\n    my laptop's lifespan\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"device_type":{"description":"smartphone | laptop | desktop | tablet | smart_tv | smartwatch | router | gaming_console | printer | camera","title":"Device Type","type":"string"}},"required":["device_type"],"title":"device_longevity_tipsArguments","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/device_type_reference":{"post":{"operationId":"device_type_reference","summary":"Every device type this toolkit covers, with its documented typical lifespan and a typical reference","description":"Every device type this toolkit covers, with its documented typical lifespan and a typical reference\n    new-device price. Use for \"what's a typical laptop lifespan\", \"what device types does this cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"device_type_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}}}}