{"openapi":"3.1.0","info":{"title":"WalletSafe API","version":"0.1.0","description":"A digital-wallet and payment-app security toolkit: a categorized best-practices checklist, a scam-pattern reference, a step-by-step lost-phone action plan, and a real weighted security self-assessment scorer — computed locally, zero upstream calls, no real transactions or payment credentials ever touched.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://walletsafe.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/walletsafe/docs"},"termsOfService":"https://connectorbay.com/walletsafe/terms"},"servers":[{"url":"https://walletsafe.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/walletsafe/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/wallet_security_checklist":{"post":{"operationId":"wallet_security_checklist","summary":"Digital-wallet security best practices grouped by category: PIN/biometric setup, lost-device","description":"Digital-wallet security best practices grouped by category: PIN/biometric setup, lost-device\n    preparedness, linked-card management hygiene, and everyday security hygiene. Use for \"how do I secure my\n    digital wallet\", \"PIN setup best practices for a payment app\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"pin_and_biometric | lost_or_stolen_device | linked_cards | everyday_hygiene. Omit for all categories.","title":"Category"}},"title":"wallet_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/scam_pattern_reference":{"post":{"operationId":"scam_pattern_reference","summary":"How specific wallet-targeted scams work, their red flags, and how to protect yourself: fake support","description":"How specific wallet-targeted scams work, their red flags, and how to protect yourself: fake support\n    calls, QR code swaps, \"send yourself money to verify\" social engineering, phishing links, and SIM swap\n    fraud. Use for \"what's a QR code swap scam\", \"how do wallet support scams work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"scam_type":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"fake_support_call | qr_code_swap | send_to_verify_scam | phishing_link | sim_swap_fraud. Omit for all patterns.","title":"Scam Type"}},"title":"scam_pattern_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/lost_phone_action_plan":{"post":{"operationId":"lost_phone_action_plan","summary":"An ordered, step-by-step action plan for a lost or stolen phone with a wallet app on it: remote","description":"An ordered, step-by-step action plan for a lost or stolen phone with a wallet app on it: remote\n    lock/wipe, freezing the wallet, contacting card issuers, suspending the SIM, changing passwords,\n    reviewing transactions, and filing a police report if stolen. Use for \"what should I do if I lose my\n    phone with my wallet app on it\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"lost_phone_action_planArguments","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 your wallet security habits out of 100 across 8 weighted checklist items, returning a risk band","description":"Scores your wallet security habits out of 100 across 8 weighted checklist items, returning a risk band\n    (weak/moderate/strong) and specific recommendations for whatever wasn't met, weighted by how much each\n    item matters. Use for \"score my wallet security habits\", \"am I doing enough to secure my digital\n    wallet\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"answers":{"additionalProperties":{"type":"boolean"},"description":"True/false for each of: pin_or_biometric_enabled, unique_pin_not_reused, auto_lock_enabled, transaction_alerts_enabled, linked_cards_reviewed_recently, no_wallet_credentials_saved_in_notes_or_email, aware_of_common_scam_patterns, phone_has_remote_wipe_configured. Missing items count as false.","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}}}}