{"openapi":"3.1.0","info":{"title":"PrivacyBasics API","version":"0.1.0","description":"A fully local, brand-neutral VPN and privacy-tool concept reference: what a VPN actually does and does not protect against, a technical comparison of VPN/Tor/privacy browsers/ad-blockers/encrypted messaging, a protects/does-not-protect checklist, a glossary of privacy-tech terms, and a neutral evaluation framework. General educational reference only, never a recommendation, endorsement, or sale of any specific product.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://privacybasics.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/privacybasics/docs"},"termsOfService":"https://connectorbay.com/privacybasics/terms"},"servers":[{"url":"https://privacybasics.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/privacybasics/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/vpn_mechanism":{"post":{"operationId":"vpn_mechanism","summary":"Explains what a VPN actually does: encrypts device-to-server traffic and hides your IP from the","description":"Explains what a VPN actually does: encrypts device-to-server traffic and hides your IP from the\n    destination — and, just as importantly, what it does NOT do (no absolute anonymity, no protection from\n    phishing/malware/weak passwords/browser fingerprinting/logged-in tracking, and the VPN provider itself can\n    see your traffic). Use for \"what does a VPN actually do\", \"does a VPN make me anonymous\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"vpn_mechanismArguments","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/category_comparison":{"post":{"operationId":"category_comparison","summary":"A genuine technical comparison of five privacy-tool categories — VPN, Tor, privacy-focused browsers,","description":"A genuine technical comparison of five privacy-tool categories — VPN, Tor, privacy-focused browsers,\n    ad/tracker blockers, and encrypted messaging: what each protects, its trust model, relative performance,\n    who operates it, typical use case, and what it does not provide. Use for \"VPN vs Tor\", \"do I need a VPN or\n    just an ad blocker\". Brand-neutral — technology categories only, never a specific product.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Filter to specific category names (e.g. ['vpn', 'tor']); omit for all five.","title":"Categories"}},"title":"category_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/protection_checklist":{"post":{"operationId":"protection_checklist","summary":"Two non-overlapping lists: what a VPN protects against (ISP-level snooping on public Wi-Fi, geographic","description":"Two non-overlapping lists: what a VPN protects against (ISP-level snooping on public Wi-Fi, geographic\n    IP masking, local-network visibility) and what it does NOT protect against (phishing, malware, weak\n    passwords, browser fingerprinting, logged-in account tracking, social engineering, device compromise). Use\n    for \"what does a VPN actually protect me from\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"protection_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/privacy_glossary":{"post":{"operationId":"privacy_glossary","summary":"Plain-language definitions of core privacy-tech terms: no-logs policy, kill switch, split tunneling, DNS","description":"Plain-language definitions of core privacy-tech terms: no-logs policy, kill switch, split tunneling, DNS\n    leak, WebRTC leak, end-to-end encryption vs. encryption-in-transit, exit node, threat model, browser\n    fingerprinting, messaging metadata, jurisdiction, independent audit, and protocol obfuscation. Use for\n    \"what's a DNS leak\", \"end-to-end encryption vs encryption in transit\".","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":"privacy_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}},"/v1/tools/evaluation_framework":{"post":{"operationId":"evaluation_framework","summary":"A neutral checklist of questions to ask before choosing ANY privacy tool or provider — jurisdiction,","description":"A neutral checklist of questions to ask before choosing ANY privacy tool or provider — jurisdiction,\n    logging-policy specificity, independent audits, open-source status, funding model, feature fit, and what\n    happens on acquisition/shutdown/legal compulsion. Never names or ranks a specific product. Use for \"what\n    should I ask before picking a VPN\", \"how do I evaluate a privacy tool\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"evaluation_frameworkArguments","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}}}}