{"openapi":"3.1.0","info":{"title":"HomeSecurityKit API","version":"0.1.0","description":"A fully local home-security toolkit: a real prioritized security-improvement checklist by home type and budget tier using a computed impact-per-cost score, and an 11-question self-assessment with a transparent, point-weighted scoring methodology. General educational guidance only, not a professional security assessment.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://homesecuritykit.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/homesecuritykit/docs"},"termsOfService":"https://connectorbay.com/homesecuritykit/terms"},"servers":[{"url":"https://homesecuritykit.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/homesecuritykit/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/security_checklist":{"post":{"operationId":"security_checklist","summary":"A real prioritized home-security improvement checklist for the given home type and budget tier. Items","description":"A real prioritized home-security improvement checklist for the given home type and budget tier. Items\n    are ranked by a computed impact-per-cost score, so cheap, high-impact items (door/window lock\n    reinforcement, motion-sensor lighting) always come before pricier, lower-impact ones (a full monitored\n    alarm or camera system) — genuine sort logic, not a hand-ordered list. A higher budget tier includes every\n    item from lower tiers plus additional higher-cost options. Use for \"security checklist for an apartment\n    on a low budget\", \"what should I do first to secure my house on a $500 budget\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"home_type":{"description":"'apartment' or 'house'.","examples":["apartment","house"],"title":"Home Type","type":"string"},"budget_tier":{"description":"'low', 'medium', or 'high'.","examples":["low","medium","high"],"title":"Budget Tier","type":"string"}},"required":["home_type","budget_tier"],"title":"security_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/security_self_assessment":{"post":{"operationId":"security_self_assessment","summary":"Scores an 11-question home-security self-assessment against a fixed 100-point rubric: each question","description":"Scores an 11-question home-security self-assessment against a fixed 100-point rubric: each question\n    carries a point weight, and you earn it only when your answer matches the protective 'good' answer (true\n    for most questions — a protection is in place; false for a couple, like hiding a spare key outside, where\n    the absence of a risky habit is the good answer). Returns the score, a risk tier, and the highest-weight\n    unmet items as prioritized recommendations. A partial set of answers is still scored fairly, as a percent\n    of the weight of questions actually answered. Use for \"score my home security\" after asking the user each\n    question.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"answers":{"additionalProperties":{"type":"boolean"},"description":"Question id -> true/false. Valid ids: deadbolts_on_exterior_doors, doors_windows_locked_when_away, exterior_entry_lighting, motion_sensor_lighting, visible_deterrent_signage_or_alarm, cameras_at_entry_points, spare_key_hidden_outside, landscaping_obstructs_visibility, mail_packages_collected_promptly, smart_device_default_passwords_changed, garage_door_opener_secured. You may answer any subset.","title":"Answers","type":"object"}},"required":["answers"],"title":"security_self_assessmentArguments","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}}}}