{ "openapi": "3.1.1", "info": { "title": "usefulweb.app API", "version": "1.0.0", "summary": "Deterministic tools for people and AI agents.", "description": "Every endpoint performs the same calculation as the human page and returns inputs, result, units, assumptions, sources, warnings and computedAt. MCP endpoint: /mcp." }, "servers": [ { "url": "https://usefulweb.app" } ], "paths": { "/api/v1/tools": { "get": { "operationId": "listTools", "summary": "Catalog of all tools", "responses": { "200": { "description": "Tool list.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/v1/tools/{id}": { "get": { "operationId": "getTool", "summary": "Definition of one tool", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "enum": [ "headerlens", "cancellation-navigator", "deadline-decoder", "decision-simulator", "form-translator", "how-long-will-it-last", "is-it-worth-it", "life-admin-generator", "repair-or-replace", "true-cost-calculator", "bill-detective", "break-even-explorer", "bulk-buy-brain", "currency-converter", "hidden-fee-finder", "historical-fx-chart", "inflation-time-machine", "multi-currency-invoice-calculator", "price-per-everything", "salary-reality-check", "subscription-stack", "travel-exchange-fee-calculator", "warranty-value-calculator", "food-storage-guide", "household-chore-rotator", "household-maintenance-calendar", "jet-lag-planner", "leftover-chef", "moving-box-planner", "room-layout-optimizer", "travel-connection-checker", "weekly-meal-planner", "will-it-fit", "ai-answer-verifier", "error-message-translator", "file-format-doctor", "privacy-policy-decoder", "prompt-to-tool-router", "scam-signal-checker", "screenshot-to-steps", "website-change-explainer", "accessibility-fixer", "before-you-sign", "digital-estate-organizer", "disaster-prep-builder", "compatibility-engine", "what-changed-in-this-law", "a11y-snapshot", "browser-compatibility-checker", "citeshape", "cyberchef-lite-pipeline", "datafresh", "filefit", "localekit", "network-speed-tester", "ruledate", "safe-markdown-preview", "timefair", "unicode-inspector", "unitproof", "unix-permission-calculator", "account-abstraction-explorer", "blockchain-incident-replay", "bridge-transfer-tracker", "cross-chain-transaction-explorer", "dao-governance-explorer", "defi-liquidation-explorer", "gas-fee-intelligence-explorer", "mev-explorer", "rollup-batch-explorer", "smart-contract-relationship-graph", "contract-upgrade-explorer", "stablecoin-flow-explorer", "token-unlock-explorer", "transaction-decoder", "wallet-permission-explorer", "asn-relationship-explorer", "bgp-route-explorer", "cdn-behavior-explorer", "certificate-transparency-explorer", "dns-certificate-explorer", "domain-history-graph", "email-infrastructure-explorer", "global-dns-explorer", "http-technology-explorer", "internet-outage-atlas", "ipv6-readiness-explorer", "artifact-provenance-explorer", "c2pa-credentials-inspector", "container-image-explorer", "cve-relationship-graph", "dependency-vulnerability-explorer", "oauth-permission-explorer", "open-source-trust-explorer", "package-ecosystem-graph", "passkey-webauthn-tester", "sbom-explorer", "sbom-license-checker", "security-advisory-timeline", "security-configuration-scanner", "api-explorer-of-explorers", "cicd-failure-explorer", "cron-job-explorer", "data-lineage-explorer", "distributed-trace-explorer", "kubernetes-event-explorer", "openapi-diff-explorer", "query-plan-visualizer", "serverless-performance-explorer", "terraform-drift-explorer", "agent-permission-graph", "ai-agent-tool-explorer", "ai-model-compatibility-explorer", "tool-call-trace-explorer", "ai-website-readiness-explorer", "llm-cost-explorer", "mcp-server-explorer", "model-behavior-regression-explorer", "rag-citation-debugger", "structured-output-validator", "energy-grid-explorer", "internet-archive-change-explorer", "public-spending-explorer", "satellite-change-explorer", "software-adoption-explorer", "explore", "chore-roulette", "elo-glicko-rating-lab", "emoji-cipher-playground", "equation-art-studio", "keyboard-heatmap-visualizer", "runtime-marathon-planner", "movie-night-consensus-picker", "padel-pickleball-scheduler", "password-entropy-race", "regex-golf-arena", "sports-what-if-simulator", "tournament-bracket-maker", "loan-amortization-calculator", "one-rep-max-calculator", "percentage-ratio-calculator", "random-generator", "running-pace-calculator", "sports-travel-fatigue-estimator", "tip-bill-split-calculator", "office-to-pdf-converter", "pdf-image-converter", "pdf-compressor", "pdf-form-signature-studio", "pdf-merge-split-reorder", "searchable-pdf-ocr", "secure-pdf-redactor", "audio-cutter-merger", "audio-loudness-normalizer", "background-remover", "batch-image-resizer", "batch-watermark-studio", "exif-inspector-cleaner", "heic-raw-converter", "image-compressor", "image-upscaler", "mp3-tag-cover-editor", "subtitle-studio", "svg-optimizer", "audio-converter", "video-converter", "vertical-video-reframer", "video-compressor", "video-cutter-merger", "video-to-gif-creator", "video-to-audio-extractor", "csv-excel-chart-studio", "diagram-flowchart-maker", "embeddable-chart-builder", "geo-data-visualizer", "time-series-explorer", "big-o-crossover-calculator", "erasure-coding-playground", "floating-point-explorer", "graph-algorithm-visualizer", "graphing-calculator", "math-workbench", "matrix-linear-algebra-lab", "number-theory-lab", "probability-statistics-studio", "equation-solver-steps", "crypto-kitchen", "hash-hmac-calculator", "key-derivation-lab", "file-encryption-studio", "password-generator", "private-breach-checker", "rsa-ecc-key-inspector", "shamir-secret-sharing", "tls-cipher-suite-simulator", "x509-certificate-inspector", "flipline-exposure-sheet", "flipline-motion-study", "lumina-image-splitter", "lumina-image-mask", "kerfwise-cabinet-builder", "kerfwise-cnc-gcode", "kerfwise-cut-list", "kerfwise-sheet-nesting", "kinetica-collision-check", "kinetica-forward-kinematics", "kinetica-inverse-kinematics", "kinetica-trajectory-planner", "lumina-blend-mixer", "lumina-layer-transform", "ohmforge-ac-sweep", "ohmforge-dc-operating-point", "ohmforge-led-resistor", "ohmforge-transient", "lumina-photo-layout", "lumina-resize-planner", "lumina-histogram-analyzer", "lumina-color-analyzer", "lumina-print-planner", "lumina-gif-maker", "lumina-tone-processor", "flipline-pixel-quantizer", "flipline-pixel-transform", "flipline-palette-converter", "flipline-retro-batch", "flipline-sprite-sheet", "threadsmith-design-stats", "threadsmith-digitize", "threadsmith-stitch-file", "twinworks-bottleneck-analysis", "twinworks-buffer-sweep", "twinworks-simulate", "twinworks-line-balance", "twinworks-queue-formulas" ] } } ], "responses": { "200": { "description": "Tool definition.", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/headerlens/calculate": { "post": { "operationId": "calculateHeaderlens", "summary": "Is a website down? Multi-region status, redirects, TLS and security headers.", "description": "Checks a public website from every configured probe region at once, separates \"down\" from \"up but blocking bots\", and explains redirects, TLS and security/caching headers in plain English.\n\nMethodology:\n- Each check probes https://host/ (falling back to http) from every configured region in parallel; each region produces its own observation.\n- Per region: DNS → TLS → bounded GET with up to 5 re-validated redirects; 401/403/429/challenge pages are \"reachable_restricted\", not \"down\".\n- Consensus: unanimous / majority / partial_outage (some regions down, others up → degraded) / no_conclusive_data.\n- Only public addresses are ever contacted (SSRF-safe: re-validated at connect time and on every redirect).", "tags": [ "developer" ], "x-mcp-tool": "headerlens", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HeaderlensInput" }, "examples": { "example1": { "summary": "example.com", "value": { "target": "example.com" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HeaderlensResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/cancellation-navigator/calculate": { "post": { "operationId": "calculateCancellationNavigator", "summary": "Verified steps to cancel Netflix, Spotify, Prime & more, plus a cancellation letter.", "description": "Choose a subscription and how you signed up. Cancellation Navigator shows the steps from the official help page (with the date we last checked it), what to do if you are billed through the App Store, Google Play or a carrier, your German online cancellation-button rights (§ 312k BGB), a ready-to-send cancellation letter and a proof-keeping checklist.\n\nMethodology:\n- Service steps were condensed from each service's official help page on the date shown (verifiedAt); nothing is added that the page does not say. If a page could not be read reliably, only the official link is given (steps not verified).\n- App Store and Google Play subscriptions are billed by Apple/Google, so the store's own cancellation steps (Apple Support, Google Play Help) are shown first for those channels.\n- Carrier/partner billing: cancel with the company that bills you (e.g. Spotify's help states partner plans are cancelled with the partner).\n- Germany: § 312k BGB (Kündigungsbutton) summary from gesetze-im-internet.de. Rights for other countries are not asserted because they were not verified.\n- Unknown services get a generic method and letter, clearly marked as unverified.\n\nNot legal advice. Service flows change; the official page linked is authoritative.", "tags": [ "everyday" ], "x-mcp-tool": "cancellation_navigator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancellationNavigatorInput" }, "examples": { "example1": { "summary": "Netflix signed up on the web, Germany", "value": { "service": "netflix", "country": "DE", "channel": "web" } }, "example2": { "summary": "ChatGPT Plus bought in the iPhone app, US", "value": { "service": "chatgpt-plus", "country": "US", "channel": "app-store" } }, "example3": { "summary": "Unknown local gym, Germany", "value": { "service": "other", "serviceName": "FitClub Musterstadt", "country": "DE", "channel": "other", "yourName": "Max Mustermann" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CancellationNavigatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/deadline-decoder/calculate": { "post": { "operationId": "calculateDeadlineDecoder", "summary": "Find every deadline, required action and consequence in a letter or notice.", "description": "Paste or upload an official letter, invoice, reminder or notice (English or German). Deadline Decoder extracts absolute dates and relative deadlines such as \"within 14 days\" or \"binnen eines Monats\", resolves them against the letter or receipt date, lists what you must do and what happens otherwise, and exports the deadlines as a calendar (.ics) file.\n\nMethodology:\n- The text is split into sentences (paragraph-, bullet- and abbreviation-aware; German ordinal dates like \"12. Oktober\" are not treated as sentence ends).\n- Absolute dates are matched in the formats 2026-10-12, 12.10.2026, 12/10/2026 (day/month or month/day as selected; an unambiguous day > 12 overrides), \"October 12, 2026\", \"12 Oct 2026\" and \"12. Oktober 2026\". Impossible dates (31.02.) are discarded.\n- A date counts as a deadline when its sentence contains a deadline cue (by, until, no later than, due, bis, spätestens, fällig, Frist …) or a required-action pattern; other dates are listed as \"mentioned\".\n- Relative deadlines (\"within 14 days\", \"no later than 30 days after receipt\", \"innerhalb von 2 Wochen\", \"binnen eines Monats\") are added to the reference date: days and weeks as calendar days, business days skip Saturdays and Sundays (public holidays are not considered), months/years as calendar months (clamped to the month end).\n- Required actions are sentences matching modal or request patterns (must, shall, required, please pay/submit, bitte, müssen, \"ist … zu zahlen\", \"überweisen Sie\" …). Consequences are sentences with otherwise/failure-to/fee/penalty/escalation patterns (andernfalls, sonst, Mahngebühr, Säumniszuschlag, Inkasso, Vollstreckung …).\n- Every finding quotes the exact sentence and names the rule that fired. Confidence is \"pattern-match\": nothing is guessed by an AI model.\n\nNot legal advice. Rule-based extraction can miss deadlines or misread dates, and legal deadline rules (e.g. when a letter counts as received, weekends and public holidays) differ by country and authority. Always check the original document and, if in doubt, ask the sender or an adviser.", "tags": [ "everyday" ], "x-mcp-tool": "deadline_decoder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeadlineDecoderInput" }, "examples": { "example1": { "summary": "German payment reminder (Mahnung)", "value": { "text": "Zahlungserinnerung\nDatum: 05.10.2026\n\nSehr geehrte Frau Muster,\nleider konnten wir bis heute keinen Zahlungseingang für die Rechnung Nr. 4711 vom 01.09.2026 feststellen. Bitte überweisen Sie den offenen Betrag von 89,90 EUR bis spätestens 20. Oktober 2026 auf das unten genannte Konto. Andernfalls müssen wir eine Mahngebühr von 5,00 EUR berechnen und die Forderung an ein Inkassobüro übergeben. Gegen diesen Bescheid kann innerhalb eines Monats nach Bekanntgabe Widerspruch eingelegt werden.", "referenceDate": "2026-10-07", "referenceType": "received", "dateOrder": "DMY" } }, "example2": { "summary": "US insurance notice", "value": { "text": "Notice date: October 1, 2026\n\nWe need additional information to process your claim. You must submit the enclosed form and a copy of your medical bills within 30 days after receipt of this notice. If we do not receive the documents, your claim will be closed. Your premium payment of $142.50 is due 10/25/2026; failure to pay by the due date may result in a late fee of $15 and cancellation of your policy.", "referenceDate": "2026-10-03", "referenceType": "received", "dateOrder": "MDY" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeadlineDecoderResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/decision-simulator/calculate": { "post": { "operationId": "calculateDecisionSimulator", "summary": "Compare 2–6 choices by expected value, worst case, best case and minimax regret.", "description": "Give each choice a worst, most likely and best outcome (money, hours, points…). The simulator computes expected values with PERT or triangular weights (or your own probabilities), then applies maximin, maximax, minimax regret and Laplace rules and explains which rule picks which choice.\n\nMethodology:\n- Each choice has three scenario outcomes: worst (W), most likely (M) and best (B).\n- PERT expected value = (W + 4M + B) ÷ 6, standard deviation ≈ (B − W) ÷ 6.\n- Triangular expected value = (W + M + B) ÷ 3, standard deviation = √((W² + M² + B² − WM − WB − MB) ÷ 18).\n- Custom: probabilities are normalised to sum to 1; EV = Σ pᵢ·xᵢ, standard deviation = √(Σ pᵢ·(xᵢ − EV)²).\n- Maximin picks the best worst case; maximax the best best case; Laplace the best unweighted average (W + M + B) ÷ 3.\n- Minimax regret treats worst / likely / best as three shared states of the world: regret = (best outcome of any choice in that state) − (this choice’s outcome); the choice with the smallest maximum regret wins.\n- When lower values are better, “best” means lowest everywhere. Ties go to the choice listed first. The recommendation is the expected-value pick.", "tags": [ "everyday" ], "x-mcp-tool": "decision_simulator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionSimulatorInput" }, "examples": { "example1": { "summary": "Job offers: first-year net gain", "value": { "goal": "maximize", "method": "pert", "unit": "EUR", "choices": [ { "name": "Stay in current job", "worst": 48000, "likely": 50000, "best": 52000 }, { "name": "Startup offer", "worst": 30000, "likely": 58000, "best": 90000 }, { "name": "Corporate offer", "worst": 50000, "likely": 55000, "best": 60000 } ] } }, "example2": { "summary": "Commute: travel minutes per day", "value": { "goal": "minimize", "method": "custom", "unit": "minutes", "choices": [ { "name": "Car", "worst": 90, "likely": 45, "best": 35, "pWorst": 10, "pLikely": 70, "pBest": 20 }, { "name": "Train", "worst": 70, "likely": 55, "best": 50, "pWorst": 15, "pLikely": 75, "pBest": 10 }, { "name": "Bike", "worst": 60, "likely": 58, "best": 55, "pWorst": 20, "pLikely": 60, "pBest": 20 } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionSimulatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/form-translator/calculate": { "post": { "operationId": "calculateFormTranslator", "summary": "Plain-language help for confusing forms: field-by-field hints and jargon explained.", "description": "Paste or upload (incl. photo/OCR) an official, insurance or tax form in English or German. Form Translator detects the fields, recognises what kind of entry each needs (date, signature, checkbox, IBAN, tax ID …), explains jargon from a curated glossary of 160 terms and lists the documents you will probably need.\n\nMethodology:\n- Lines are scanned for field labels: \"Label:\" followed by blanks, labels next to fill lines (____ or ....), checkbox options (☐, □, [ ], ( )) and short label-only lines that contain a field keyword.\n- Each label is classified with keyword rules into field types (date, signature, checkbox, IBAN/bank, tax ID, ID/reference number, e-mail, phone, address, name, amount, marital status, nationality, place+date), each with a fixed fill-in hint.\n- Jargon is matched against an editorial glossary (160 English and German admin, tax, insurance, benefits, banking and legal terms incl. inflected German forms). Explanations are written by usefulweb.site editors, not generated.\n- Documents are listed when a sentence asks to attach/enclose/provide proof (beifügen, Nachweis, Kopie, Bescheinigung …), quoted verbatim, plus documents commonly requested for recognised glossary terms (marked as such).\n- IBANs found in the text are checked with the ISO 13616 mod-97 checksum (German IBANs must have 22 characters). A valid checksum does not prove the account exists.\n\nNot legal, tax or insurance advice. Explanations are editorial plain-language summaries for orientation and may not match the exact legal meaning in your country, contract or authority. The detection is rule-based and never complete; when in doubt, ask the issuing office.", "tags": [ "everyday" ], "x-mcp-tool": "form_translator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormTranslatorInput" }, "examples": { "example1": { "summary": "German Kindergeld-style application", "value": { "text": "Antrag auf Kindergeld\n\n1. Angaben zur antragstellenden Person\nName, Vorname: ______________________\nGeburtsdatum (TT.MM.JJJJ): __________\nSteuer-ID: ___________\nAnschrift (Straße, Hausnummer, PLZ, Ort): ____________________\nFamilienstand:\n☐ ledig ☐ verheiratet ☐ geschieden ☐ verwitwet\n\n2. Angaben zum Ehegatten / eingetragenen Lebenspartner\nName, Vorname: ______________\n\n3. Bankverbindung\nIBAN: DE89 3704 0044 0532 0130 00\nKontoinhaber: ______________\n\nBitte fügen Sie eine Kopie der Geburtsurkunde und ggf. eine Schulbescheinigung bei.\nIch versichere, dass meine Angaben vollständig und richtig sind.\nOrt, Datum: ____________ Unterschrift: ________________" } }, "example2": { "summary": "US health insurance enrollment", "value": { "text": "Health Plan Enrollment Form\n\nPolicyholder name: ____________\nDate of birth (MM/DD/YYYY): ________\nSocial Security Number: ___-__-____\nMarital status: [ ] Single [ ] Married [ ] Divorced\nDependents (name, DOB, relationship): ______________\nPrimary beneficiary: ______________\n\nPlan options: The Silver plan has a $2,000 deductible, 20% coinsurance and a $30 copay for primary care visits.\nDo you have a pre-existing condition? [ ] Yes [ ] No\n\nPlease attach a copy of your ID and proof of address.\nSignature of applicant: ______________ Date: ________" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormTranslatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/how-long-will-it-last/calculate": { "post": { "operationId": "calculateHowLongWillItLast", "summary": "Estimate remaining life of appliances and home components and plan the replacement.", "description": "Pick an appliance or home component, enter its age, how hard it is used and how well it is maintained. The tool uses the life-expectancy ranges published in InterNACHI's Standard Estimated Life Expectancy Chart for Homes to estimate remaining years, the share of life used, and a replacement planning window.\n\nMethodology:\n- Base range: the YEARS value for the item from InterNACHI's Standard Estimated Life Expectancy Chart for Homes (e.g. '9 to 13'). Single values use the same min and max; 'N+' values are open-ended (only a minimum).\n- Adjusted range = base range × usage multiplier (light 1.15, normal 1.0, heavy 0.8) × maintenance multiplier (regular 1.0, occasional 0.9, neglected 0.75). These multipliers are this tool's own assumptions, not published figures; InterNACHI's values already assume regular recommended maintenance and normal wear and tear.\n- Remaining years = max(0, adjusted min − age) to max(0, adjusted max − age).\n- Life used = age ÷ midpoint of the adjusted range × 100 (open-ended: ÷ adjusted minimum).\n- Status: < 50% early life, 50–80% mid-life, ≥ 80% but below adjusted minimum approaching end, between adjusted min and max within end-of-life range, beyond adjusted max beyond expected life.\n- Replacement window = current year + remaining min … current year + remaining max (rounded to whole years).\n\nLife expectancies are guidelines only, not guarantees or warranties (InterNACHI).", "tags": [ "everyday" ], "x-mcp-tool": "how_long_will_it_last", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HowLongWillItLastInput" }, "examples": { "example1": { "summary": "7-year-old refrigerator, normal use", "value": { "item": "refrigerator", "ageYears": 7, "usage": "normal", "maintenance": "good" } }, "example2": { "summary": "10-year-old water heater, heavy use, occasional maintenance", "value": { "item": "water-heater", "ageYears": 10, "usage": "heavy", "maintenance": "average" } }, "example3": { "summary": "4-year-old washing machine, light use", "value": { "item": "washing-machine", "ageYears": 4, "usage": "light", "maintenance": "good" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HowLongWillItLastResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/is-it-worth-it/calculate": { "post": { "operationId": "calculateIsItWorthIt", "summary": "Buy, rent, repair or subscribe? Compare total cost and NPV over the years you need it.", "description": "Enter the options you are considering (buy new, rent, repair what you have, subscribe) with upfront, monthly and one-off costs, resale value and a repair allowance. The tool computes total cost of ownership, net present value of costs, cost per month, a ranking and when the best option overtakes the runner-up.\n\nMethodology:\n- Annual running cost = recurring per month × 12 + repair allowance per year.\n- Total cost (nominal) = upfront + one-off costs + years × annual running cost − resale value.\n- NPV cost = upfront + one-off ÷ (1 + r)^y + Σ(t = 1..N) annual running cost ÷ (1 + r)^t − resale ÷ (1 + r)^N, where r = discount rate and y = the one-off year (running costs are discounted at each year end).\n- Cost per month = total cost ÷ (12 × years); NPV cost per month = NPV cost ÷ (12 × years).\n- Options are ranked by NPV cost (lowest first); ties keep input order.\n- Break-even: nominal cumulative costs of the best and runner-up options are compared at each year end (resale counted only at the end, one-off costs from their year) and the crossing point is interpolated linearly.", "tags": [ "everyday" ], "x-mcp-tool": "is_it_worth_it", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IsItWorthItInput" }, "examples": { "example1": { "summary": "Washing machine: buy, rent or repair the old one (5 years)", "value": { "years": 5, "discountRatePercent": 3, "currency": "EUR", "options": [ { "name": "Buy new", "kind": "buy", "upfront": 650, "resale": 100, "repairPerYear": 20 }, { "name": "Rent", "kind": "rent", "monthly": 15, "oneOff": 30 }, { "name": "Repair old", "kind": "repair", "upfront": 220, "repairPerYear": 60, "oneOff": 650, "oneOffYear": 3 } ] } }, "example2": { "summary": "Design software: perpetual licence vs subscription (4 years)", "value": { "years": 4, "discountRatePercent": 4, "currency": "USD", "options": [ { "name": "Perpetual licence + 1 upgrade", "kind": "buy", "upfront": 399, "oneOff": 149, "oneOffYear": 2 }, { "name": "Monthly subscription", "kind": "subscribe", "monthly": 12.99 } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IsItWorthItResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/life-admin-generator/calculate": { "post": { "operationId": "calculateLifeAdminGenerator", "summary": "A dated to-do list for moving, marriage, a baby, a new job and other life events.", "description": "Choose a life event, your country, the date and your circumstances. You get a personalised before / on-the-day / after checklist with due dates. Legal deadlines are only stated where verified against official sources (e.g. German Anmeldung within two weeks); everything else is clearly marked as a recommendation.\n\nMethodology:\n- A rule catalog maps each life event to tasks with an offset in days relative to the event date (negative = before). Rules can be limited to countries and to circumstances (e.g. lease notice only when renting).\n- Due date = event date + offset (calendar days). Items are grouped into before, on the day and after, sorted by due date then id.\n- Country-specific legal deadlines are only included where verified against an official source (Germany: BMG § 17, PStG §§ 18 and 28; Austria: oesterreich.gv.at; Switzerland: ch.ch; UK: GOV.UK birth and death registration). Only those are marked mandatory and cited.\n- For other countries and topics the item is phrased as \"check local requirements\"; offsets for recommendations are editorial planning suggestions.\n\nOrganisational help, not legal advice. Rules change and have exceptions — confirm deadlines with the responsible authority.", "tags": [ "everyday" ], "x-mcp-tool": "life_admin_generator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifeAdminGeneratorInput" }, "examples": { "example1": { "summary": "Moving home in Germany (renting, car)", "value": { "event": "moving", "country": "de", "eventDate": "2026-12-01", "circumstances": [ "renting", "has-car", "employed" ] } }, "example2": { "summary": "Having a baby in the UK", "value": { "event": "baby", "country": "uk", "eventDate": "2027-03-20", "circumstances": [ "employed", "has-car" ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifeAdminGeneratorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/repair-or-replace/calculate": { "post": { "operationId": "calculateRepairOrReplace", "summary": "Fix it or buy new? The 50% rule plus a cost-per-year check, with a clear verdict.", "description": "Enter the age and expected lifespan of a broken item, the repair quote, the replacement price and running costs. The tool applies the common 50% rule of thumb and compares the cost per remaining year of repairing versus replacing, including the risk of another failure, and gives a reasoned verdict.\n\nMethodology:\n- 50% rule of thumb: if the repair quote is more than the threshold (default 50%) of the replacement price, replace; otherwise repair. This is a common heuristic, not a law or standard.\n- Expected extra repair cost = P(another failure) × next repair cost (defaults to the current quote).\n- Repair cost per year = (repair quote + expected extra repair cost) ÷ expected extra life + running cost of the old item per year.\n- Replace cost per year = replacement price ÷ lifespan of the new item + running cost of the new item per year.\n- Break-even repair quote = (replace cost per year − old running cost) × extra life − expected extra repair cost (floored at 0).\n- Final verdict follows the cost-per-year comparison, because it accounts for remaining life, failure risk and running costs; the 50% rule is shown as a cross-check.", "tags": [ "everyday" ], "x-mcp-tool": "repair_or_replace", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RepairOrReplaceInput" }, "examples": { "example1": { "summary": "Washing machine with a failed drum bearing", "value": { "itemName": "Washing machine", "currency": "EUR", "itemAgeYears": 8, "expectedLifespanYears": 11, "replacementPrice": 550, "repairQuote": 320, "lifeAfterRepairYears": 3, "runningCostOldPerYear": 75, "runningCostNewPerYear": 55, "failureProbabilityPercent": 35, "ruleThresholdPercent": 50 } }, "example2": { "summary": "Laptop with a dead battery", "value": { "itemName": "Laptop", "currency": "USD", "itemAgeYears": 3, "expectedLifespanYears": 6, "replacementPrice": 1200, "repairQuote": 150, "lifeAfterRepairYears": 3, "runningCostOldPerYear": 0, "runningCostNewPerYear": 0, "failureProbabilityPercent": 15, "ruleThresholdPercent": 50 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RepairOrReplaceResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/true-cost-calculator/calculate": { "post": { "operationId": "calculateTrueCostCalculator", "summary": "What a car, pet, appliance, home or gadget really costs per year, month and day.", "description": "Add the purchase price, financing, expected resale value, recurring costs, maintenance, insurance and energy use. The calculator returns the true total cost of ownership, the cost per year, month and day, the share of each cost bucket, and how many times the sticker price you really pay.\n\nMethodology:\n- Depreciation = purchase price − expected resale value (the money you will not get back).\n- Loan interest is computed from an exact monthly annuity schedule: payment = L·i ÷ (1 − (1 + i)^−n) with i = APR ÷ 12 and n = term in months; only interest falling within the ownership period (years × 12 months) is counted.\n- Recurring costs are annualised: weekly × 365.25/7, monthly × 12, quarterly × 4, yearly × 1; then multiplied by years owned.\n- Energy, fuel or food per year = consumption ÷ (1 or 100) × usage per year × price per unit.\n- True total = depreciation + loan interest + years × (recurring + maintenance or vet care + insurance + energy, fuel or food per year).\n- Per year = total ÷ years; per month = total ÷ (12 × years); per day = total ÷ (365.25 × years). Sticker multiplier = total ÷ purchase price.", "tags": [ "everyday" ], "x-mcp-tool": "true_cost_calculator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrueCostCalculatorInput" }, "examples": { "example1": { "summary": "Compact car, financed, 6 years", "value": { "itemType": "car", "itemName": "Compact car", "currency": "EUR", "purchasePrice": 24000, "yearsOwned": 6, "resaleValue": 9000, "loanAmount": 15000, "aprPercent": 5.9, "loanTermMonths": 48, "maintenancePerYear": 600, "insurancePerYear": 750, "energyConsumption": 6, "consumptionPer": "per-100", "energyUnitPrice": 1.75, "usagePerYear": 12000, "recurring": [ { "name": "Vehicle tax", "amount": 120, "frequency": "yearly" }, { "name": "Parking permit", "amount": 30, "frequency": "monthly" } ] } }, "example2": { "summary": "Medium-sized dog, 12 years", "value": { "itemType": "pet", "itemName": "Dog", "currency": "EUR", "purchasePrice": 900, "yearsOwned": 12, "resaleValue": 0, "loanAmount": 0, "aprPercent": 0, "loanTermMonths": 0, "insurancePerYear": 240, "maintenancePerYear": 250, "energyConsumption": 0.35, "consumptionPer": "per-1", "energyUnitPrice": 6, "usagePerYear": 365, "recurring": [ { "name": "Dog tax", "amount": 100, "frequency": "yearly" }, { "name": "Toys & treats", "amount": 10, "frequency": "monthly" } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrueCostCalculatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/bill-detective/calculate": { "post": { "operationId": "calculateBillDetective", "summary": "Spot spikes, price changes and calculation errors across your utility bills.", "description": "Enter several billing periods of an electricity, gas, water or data bill. Bill Detective normalises consumption per day, flags unusual periods (outliers), unit-price and standing-charge changes, and totals that do not add up, each with a plain-English explanation.\n\nMethodology:\n- Days = end date − start date + 1 (both dates count). Consumption per day = consumption ÷ days. Periods are sorted by start date.\n- Computed total = consumption × unit price + fixed charge + other charges. A mismatch is flagged when |total billed − computed| > tolerance % × computed (minimum 0.01).\n- Consumption change: per-day consumption vs. the previous period; flagged when the absolute change exceeds the threshold (default 25%).\n- Above average: per-day consumption more than the threshold above the average of all periods.\n- Outliers (IQR rule, only with ≥ 4 periods): per-day value above Q3 + 1.5 × IQR or below Q1 − 1.5 × IQR, quartiles by linear interpolation.\n- Outliers (median rule): per-day value more than X% (default 30%) above the median per-day value.\n- Unit price change: any change vs. the previous period. Fixed charge change: both the fixed charge per period and the fixed charge per day differ from the previous period by more than 1% (so a flat monthly fee over months of different length, or a fixed daily rate, is not flagged).\n- Gaps and overlaps between consecutive periods are reported as information.", "tags": [ "money" ], "x-mcp-tool": "bill_detective", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BillDetectiveInput" }, "examples": { "example1": { "summary": "Monthly electricity with a winter spike and a price rise", "value": { "unit": "kWh", "currency": "EUR", "periods": [ { "label": "Jan", "startDate": "2026-01-01", "endDate": "2026-01-31", "consumption": 310, "unitPrice": 0.32, "fixedCharge": 12, "totalBilled": 111.2 }, { "label": "Feb", "startDate": "2026-02-01", "endDate": "2026-02-28", "consumption": 280, "unitPrice": 0.32, "fixedCharge": 12, "totalBilled": 101.6 }, { "label": "Mar", "startDate": "2026-03-01", "endDate": "2026-03-31", "consumption": 300, "unitPrice": 0.32, "fixedCharge": 12, "totalBilled": 108 }, { "label": "Apr", "startDate": "2026-04-01", "endDate": "2026-04-30", "consumption": 290, "unitPrice": 0.35, "fixedCharge": 12, "totalBilled": 113.5 }, { "label": "May", "startDate": "2026-05-01", "endDate": "2026-05-31", "consumption": 520, "unitPrice": 0.35, "fixedCharge": 14, "totalBilled": 198 }, { "label": "Jun", "startDate": "2026-06-01", "endDate": "2026-06-30", "consumption": 295, "unitPrice": 0.35, "fixedCharge": 14, "totalBilled": 117.25 } ] } }, "example2": { "summary": "Quarterly water bills", "value": { "unit": "m3", "currency": "GBP", "periods": [ { "label": "Q1", "startDate": "2025-01-01", "endDate": "2025-03-31", "consumption": 24, "unitPrice": 2.1, "fixedCharge": 18, "totalBilled": 68.4 }, { "label": "Q2", "startDate": "2025-04-01", "endDate": "2025-06-30", "consumption": 26, "unitPrice": 2.1, "fixedCharge": 18, "totalBilled": 72.6 }, { "label": "Q3", "startDate": "2025-07-01", "endDate": "2025-09-30", "consumption": 31, "unitPrice": 2.25, "fixedCharge": 18, "totalBilled": 87.75 } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BillDetectiveResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/break-even-explorer/calculate": { "post": { "operationId": "calculateBreakEvenExplorer", "summary": "When does an investment pay for itself? Payback, NPV and IRR for solar, EVs, heat pumps…", "description": "Enter an upfront investment, subsidies and the yearly savings it brings, with optional price escalation, performance degradation and maintenance. The explorer returns simple and discounted payback (fractional years), NPV, IRR and a year-by-year cumulative cash-flow table.\n\nMethodology:\n- Net investment (year 0 outflow) = upfront investment − subsidies.\n- Savings in year t = year-1 savings × (1 + escalation)^(t−1) × (1 − degradation)^(t−1), unless overridden for that year.\n- Net cash flow in year t = savings − maintenance (maintenance is constant in nominal terms).\n- Simple payback = the year in which cumulative cash flow turns non-negative, interpolated linearly within that year (savings assumed to accrue evenly).\n- Discounted payback uses cash flows discounted by (1 + r)^t; NPV = −net investment + Σ net cash flow ÷ (1 + r)^t.\n- IRR = the rate at which NPV = 0, found by bisection between −99% and 1000% (null if NPV does not change sign in that range).\n- Presets only supply defaults for escalation, degradation and horizon when those fields are left empty; the values used are always listed.", "tags": [ "money" ], "x-mcp-tool": "break_even_explorer", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BreakEvenExplorerInput" }, "examples": { "example1": { "summary": "Rooftop solar with a grant", "value": { "preset": "solar", "currency": "EUR", "upfrontInvestment": 12000, "subsidies": 1500, "annualSavings": 1100, "maintenancePerYear": 100, "discountRatePercent": 3 } }, "example2": { "summary": "Insulation project, flat savings, 15 years", "value": { "preset": "custom", "currency": "EUR", "upfrontInvestment": 6000, "subsidies": 0, "annualSavings": 700, "savingsEscalationPercent": 0, "degradationPercent": 0, "maintenancePerYear": 0, "discountRatePercent": 4, "horizonYears": 15 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BreakEvenExplorerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/bulk-buy-brain/calculate": { "post": { "operationId": "calculateBulkBuyBrain", "summary": "Is the bulk pack really cheaper once waste, storage and tied-up cash are counted?", "description": "Compare a small pack with a bulk pack using how fast you actually use the product, its shelf life, storage cost and the interest your money could earn. The tool computes the effective cost per unit you actually use, your saving or loss, and the largest bulk size worth buying.\n\nMethodology:\n- Small-pack unit price ps = small price ÷ small quantity (small packs bought as needed, no waste). Bulk unit price pb = bulk price ÷ bulk quantity.\n- Usable quantity = min(bulk quantity, consumption per week × shelf life); waste = bulk quantity − usable quantity.\n- Weeks held = usable quantity ÷ consumption per week. Storage cost = storage cost per week × weeks held.\n- Opportunity cost = bulk price × interest rate × (weeks held ÷ 52.18) ÷ 2 (the prepaid amount is drawn down linearly, so on average half is tied up).\n- Effective cost per used unit = (bulk price + storage + opportunity cost) ÷ usable quantity. Savings = ps × usable quantity − bulk total cost.\n- Max worthwhile size: the largest Q for which pb·Q + storage + opportunity cost ≤ ps × usable(Q), solved in closed form for the no-waste and the waste regime.", "tags": [ "money" ], "x-mcp-tool": "bulk_buy_brain", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkBuyBrainInput" }, "examples": { "example1": { "summary": "Toilet paper: 8 rolls vs 48 rolls", "value": { "currency": "EUR", "unitLabel": "rolls", "smallPrice": 3.49, "smallQuantity": 8, "bulkPrice": 17.99, "bulkQuantity": 48, "consumptionPerWeek": 3, "storageCostPerWeek": 0, "interestRatePercent": 3 } }, "example2": { "summary": "Greek yoghurt: 500 g vs 2 kg tub (spoils)", "value": { "currency": "EUR", "unitLabel": "g", "smallPrice": 2.29, "smallQuantity": 500, "bulkPrice": 6.99, "bulkQuantity": 2000, "consumptionPerWeek": 600, "shelfLifeWeeks": 2, "storageCostPerWeek": 0, "interestRatePercent": 3 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkBuyBrainResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/currency-converter/calculate": { "post": { "operationId": "calculateCurrencyConverter", "summary": "Convert an amount into several currencies at ECB euro reference rates, with rate date and source.", "description": "Converts an amount between the 30 currencies of the European Central Bank’s daily euro foreign exchange reference rates – into several target currencies at once, at the latest rates or those of a past date. Cross rates are calculated via the euro; every result shows the rate, the inverse rate, the reference date and the source.\n\nMethodology:\n- Rates come from the ECB’s daily reference-rate file (eurofxref-daily.xml) or, for past dates, from the ECB Data Portal (dataset EXR, daily series D..EUR.SP00.A). They are cached per day; the daily file is re-checked at most hourly until the day’s rates (around 16:00 CET) are available.\n- All ECB rates are quoted as units of currency per 1 euro, so a cross rate is rate(to) ÷ rate(from); converting X from A to B = X × rate(B) ÷ rate(A). Rates are shown with 6 significant digits; amounts are rounded half away from zero to the currency’s minor units (0 for JPY, KRW and ISK).\n- For a date without a publication (weekends, TARGET holidays) the last earlier publication is used and named.\n- Reference rates are published for information only. Card schemes, banks and exchange offices use their own rates and add fees, so the amount you actually pay or receive will differ.\n\nECB reference rates are not transaction rates. For a real payment, check your provider’s rate and fees.", "tags": [ "money" ], "x-mcp-tool": "currency_converter", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CurrencyConverterInput" }, "examples": { "example1": { "summary": "100 EUR into USD, GBP, CHF and JPY (latest)", "value": { "amount": 100, "from": "EUR", "to": "USD, GBP, CHF, JPY" } }, "example2": { "summary": "250 USD into EUR and GBP on 2024-01-02", "value": { "amount": 250, "from": "USD", "to": "EUR, GBP", "date": "2024-01-02" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CurrencyConverterResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/hidden-fee-finder/calculate": { "post": { "operationId": "calculateHiddenFeeFinder", "summary": "Paste a quote, contract or invoice and see every fee, tax, penalty and add-on.", "description": "Paste the lines of a quote, rental contract, booking or invoice (English or German). Hidden Fee Finder extracts the amounts, classifies each line with transparent keyword rules (base price, fee, tax, surcharge, penalty, deposit, discount, insurance/add-on, recurring), flags conditional penalties and optional add-ons, and shows how much of the total is not the base price.\n\nMethodology:\n- Each non-empty line is scanned for amounts. A number counts as money if it has a currency marker (€, $, £, EUR, USD, GBP, CHF…), exactly two decimals, or ends the line; the last such amount on a line is used. A number followed by % is a percentage.\n- Number formats: with both separators the last one is the decimal mark; \"1,234\" (comma + 3 digits) is read as a thousands separator in auto mode, \"12,50\" as a decimal; choose a fixed format to override.\n- Categories are assigned by ordered keyword rules (total → penalty → deposit → discount → tax → insurance/add-on → surcharge → fee → recurring → base). The first matching keyword is shown. Lines without any keyword default to base price.\n- Flags: conditional (late, cancellation, early termination, if, per day, wenn, falls, Verzug, pro Tag…), recurring (monthly, per year, subscription, monatlich…), optional/hidden (optional, pre-selected, recommended, auto-renew, empfohlen, voreingestellt…), included tax (incl./inkl./included).\n- Payable total = base + fees + taxes + surcharges + insurance/add-ons + recurring + discounts. Excluded: deposits (refundable), conditional lines (only if triggered), total lines, and taxes marked as included.\n- Percent-only lines: taxes are applied to the sum of all other included lines; other percentages are applied to the base total.\n- Non-base share = (payable total − base − discounts) ÷ payable total.", "tags": [ "money" ], "x-mcp-tool": "hidden_fee_finder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HiddenFeeFinderInput" }, "examples": { "example1": { "summary": "Hotel booking with resort fee and conditional charges", "value": { "currency": "USD", "text": "Room rate, 3 nights: $420.00\nResort fee (mandatory): $105.00\nCity tax: 6%\nTravel insurance (pre-selected, optional): $29.99\nLate checkout fee if after 12:00: $50.00\nSecurity deposit (refundable): $200.00\nMember discount: -$21.00\nTotal: $566.03" } }, "example2": { "summary": "German rental quote", "value": { "currency": "EUR", "numberFormat": "de", "text": "Grundpreis Miete Transporter 1 Tag 89,00 €\nBearbeitungsgebühr 15,00 €\nWochenendzuschlag 20,00 €\nVollkaskoversicherung optional 24,90 €\nKaution 300,00 €\nVertragsstrafe bei verspäteter Rückgabe pro Tag 75,00 €\nGesamtbetrag inkl. 19% MwSt. 148,90 €" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HiddenFeeFinderResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/historical-fx-chart/calculate": { "post": { "operationId": "calculateHistoricalFxChart", "summary": "Chart exchange rates over time from ECB data: min, max, average, change, volatility and CSV export.", "description": "Pick a base currency, one or more quote currencies and a date range (back to 1999). The tool loads the ECB’s daily euro reference rates, builds the cross rates, draws a line chart (indexed to 100 to compare several pairs) and reports start, end, minimum, maximum, average, change and annualised volatility, with a CSV download.\n\nMethodology:\n- Daily reference rates (units per euro) are loaded from the ECB Data Portal SDMX API as CSV (series D..EUR.SP00.A, only the requested currencies and dates) and cached; ranges ending more than a week ago are cached permanently, recent ranges per day.\n- Cross rate base/quote on each publication day = rate(quote) ÷ rate(base); days where either leg is missing are skipped. EUR legs are 1.\n- Statistics: first and last observation, minimum and maximum with dates, arithmetic mean, change = last ÷ first − 1, annualised volatility = standard deviation of daily log returns × √252.\n- Indexed view: every pair divided by its first value × 100, so pairs with very different levels (e.g. JPY and GBP) can be compared.\n\nReference rates for information; they are not the rates at which you could have traded.", "tags": [ "money" ], "x-mcp-tool": "historical_fx_chart", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HistoricalFxChartInput" }, "examples": { "example1": { "summary": "EUR/USD and EUR/GBP over 2024 (indexed)", "value": { "base": "EUR", "quotes": "USD, GBP", "start": "2024-01-01", "end": "2024-12-31" } }, "example2": { "summary": "USD/JPY in 2023", "value": { "base": "USD", "quotes": "JPY", "start": "2023-01-01", "end": "2023-12-31", "png": false } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HistoricalFxChartResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/inflation-time-machine/calculate": { "post": { "operationId": "calculateInflationTimeMachine", "summary": "What was money from one year worth in another? CPI-based, 20 countries, World Bank data.", "description": "Convert an amount between years with the consumer price index (2010 = 100) published by the World Bank. Shows the equivalent value, cumulative inflation, average annual inflation and lost purchasing power, with a year-by-year table.\n\nMethodology:\n- Data: World Bank WDI indicator FP.CPI.TOTL, consumer price index (2010 = 100), annual averages, snapshot stored with retrieval date.\n- Equivalent value = amount × CPI(to year) ÷ CPI(from year).\n- Cumulative inflation = (CPI(later) ÷ CPI(earlier) − 1) × 100.\n- Average annual inflation (CAGR) = ((CPI(later) ÷ CPI(earlier))^(1 ÷ years) − 1) × 100.\n- Purchasing power loss = (1 − CPI(earlier) ÷ CPI(later)) × 100: how much less the same nominal amount buys in the later year.\n- Because CPI values are annual averages, results compare average price levels of whole years, not specific dates.", "tags": [ "money" ], "x-mcp-tool": "inflation_time_machine", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InflationTimeMachineInput" }, "examples": { "example1": { "summary": "100 EUR in Germany, 2000 → 2024", "value": { "amount": 100, "currency": "EUR", "fromYear": 2000, "toYear": 2024, "country": "DE" } }, "example2": { "summary": "1,000 USD in the US, 1980 → 2024", "value": { "amount": 1000, "currency": "USD", "fromYear": 1980, "toYear": 2024, "country": "US" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InflationTimeMachineResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/multi-currency-invoice-calculator/calculate": { "post": { "operationId": "calculateMultiCurrencyInvoiceCalculator", "summary": "Convert invoice lines in different currencies at ECB reference rates, with VAT, rounding and totals.", "description": "Enter invoice lines in different currencies, the invoice currency and a rate date. The calculator converts every line at the ECB euro reference rates of that date (or your own rates), applies VAT per line, shows the VAT summary and totals with either per-line or per-document rounding (and the difference between both), and writes the “converted at the ECB reference rate of …” statement. Download as CSV or an HTML table.\n\nMethodology:\n- Each line’s net amount = quantity × unit price, rounded to the minor units of its own currency, then converted with the cross rate rate(invoice currency) ÷ rate(line currency), both quoted per euro by the ECB.\n- Per-line rounding: each converted net amount and its VAT are rounded to the invoice currency’s minor units and then added up. Per-document rounding: exact converted amounts are added up per VAT rate, the net subtotal is rounded and VAT is calculated once per rate. Both totals are shown, because tax authorities and accounting systems differ in which they expect.\n- Rounding is half away from zero (commercial rounding). Lines without a currency use the invoice currency; lines without a VAT rate have 0 %.\n- ECB rates for a date are the last publication on or before it (none on weekends and TARGET holidays). Manual rates are entered per euro, exactly like the ECB quotes.\n\nNot tax advice. Check which exchange rate and rounding your tax authority requires for invoices and VAT returns.", "tags": [ "money" ], "x-mcp-tool": "multi_currency_invoice_calculator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MultiCurrencyInvoiceCalculatorInput" }, "examples": { "example1": { "summary": "EUR invoice with USD and GBP costs (manual ECB-style rates)", "value": { "invoiceCurrency": "EUR", "rateSource": "manual", "rateDate": "2026-10-16", "manualRates": "USD 1.1253\nGBP 0.84385", "lines": [ { "description": "Consulting (days)", "quantity": 3, "unitPrice": 850, "currency": "EUR", "vatRate": 19 }, { "description": "Cloud hosting", "quantity": 1, "unitPrice": 412.37, "currency": "USD", "vatRate": 19 }, { "description": "Conference ticket", "quantity": 2, "unitPrice": 299.99, "currency": "GBP", "vatRate": 7 }, { "description": "Travel expenses (no VAT)", "quantity": 1, "unitPrice": 123.45, "currency": "USD", "vatRate": 0 } ], "rounding": "line" } }, "example2": { "summary": "CHF invoice, document rounding (cross rates via EUR)", "value": { "invoiceCurrency": "CHF", "rateSource": "manual", "manualRates": "CHF 0.9272\nUSD 1.1253\nJPY 177.82", "rounding": "document", "lines": [ { "description": "Licences", "quantity": 7, "unitPrice": 19.99, "currency": "USD", "vatRate": 8.1 }, { "description": "Support", "quantity": 1, "unitPrice": 15000, "currency": "JPY", "vatRate": 8.1 }, { "description": "Setup", "quantity": 1, "unitPrice": 250, "currency": "CHF", "vatRate": 8.1 } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MultiCurrencyInvoiceCalculatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/price-per-everything/calculate": { "post": { "operationId": "calculatePricePerEverything", "summary": "Compare products by price per gram, use, serving, hour or year of life.", "description": "Enter two or more products with their price and quantity (grams, uses, servings, hours or years). Price Per Everything normalises them to the same basis, accounts for waste, and ranks them from cheapest to most expensive per unit.\n\nMethodology:\n- Usable quantity = quantity × (1 − waste %).\n- Price per unit = price ÷ usable quantity, unrounded internally; displayed with 4 significant digits.\n- Products are ranked by price per unit; ties keep input order.", "tags": [ "money" ], "x-mcp-tool": "price_per_everything", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PricePerEverythingInput" }, "examples": { "example1": { "summary": "Coffee: small vs. large bag", "value": { "basis": "unit", "currency": "EUR", "products": [ { "name": "Coffee 250 g", "price": 4.99, "quantity": 250, "unit": "g" }, { "name": "Coffee 1 kg", "price": 15.49, "quantity": 1000, "unit": "g", "wastePercent": 10 } ] } }, "example2": { "summary": "Shoes: cost per wear", "value": { "basis": "use", "currency": "USD", "products": [ { "name": "Budget sneakers", "price": 40, "quantity": 120 }, { "name": "Leather boots", "price": 180, "quantity": 900 } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PricePerEverythingResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/salary-reality-check/calculate": { "post": { "operationId": "calculateSalaryRealityCheck", "summary": "Compare job offers by real net pay per hour, including commute time and living costs.", "description": "Enter 2–4 job offers with salary, your own effective tax rate, bonus, benefits, commute and cost-of-living differences. The tool ranks them by net income per hour of working plus commuting time, so a higher salary with a long commute or an expensive city is put into perspective.\n\nMethodology:\n- Gross total = gross salary + annual bonus. Net annual = gross total × (1 − effective tax+social rate) + benefits value (benefits are treated as already net).\n- The effective tax+social rate is supplied by you; no national tax rules are applied.\n- Commute days per year = working days × (1 − remote days per week ÷ 5). Commute hours = commute days × 2 × one-way minutes ÷ 60.\n- Work hours per year = weekly hours ÷ 5 × working days (a 5-day week is assumed).\n- Net after costs = net annual − 12 × monthly commute cost − 12 × monthly living cost difference.\n- Net per hour incl. commute = net after costs ÷ (work hours + commute hours). Offers are ranked by this value; ties keep input order.\n- Value of commute time = commute hours × (net annual ÷ work hours).", "tags": [ "money" ], "x-mcp-tool": "salary_reality_check", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalaryRealityCheckInput" }, "examples": { "example1": { "summary": "City job vs. remote-friendly job", "value": { "currency": "EUR", "offers": [ { "name": "Big-city bank", "grossAnnual": 72000, "taxRatePercent": 42, "bonus": 6000, "benefitsValue": 1200, "commuteMinutesOneWay": 55, "commuteCostMonthly": 90, "workingDays": 220, "weeklyHours": 42, "livingCostDiffMonthly": 450, "remoteDaysPerWeek": 1 }, { "name": "Local software firm", "grossAnnual": 62000, "taxRatePercent": 39, "bonus": 0, "benefitsValue": 800, "commuteMinutesOneWay": 20, "commuteCostMonthly": 40, "workingDays": 220, "weeklyHours": 40, "livingCostDiffMonthly": 0, "remoteDaysPerWeek": 3 } ] } }, "example2": { "summary": "Three offers with different hours", "value": { "currency": "USD", "offers": [ { "name": "Startup", "grossAnnual": 95000, "taxRatePercent": 30, "benefitsValue": 3000, "commuteMinutesOneWay": 30, "commuteCostMonthly": 120, "weeklyHours": 50 }, { "name": "Corporate", "grossAnnual": 105000, "taxRatePercent": 32, "bonus": 10000, "benefitsValue": 8000, "commuteMinutesOneWay": 60, "commuteCostMonthly": 250, "weeklyHours": 45 }, { "name": "Fully remote", "grossAnnual": 88000, "taxRatePercent": 29, "benefitsValue": 2000, "remoteDaysPerWeek": 5, "weeklyHours": 40 } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SalaryRealityCheckResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/subscription-stack/calculate": { "post": { "operationId": "calculateSubscriptionStack", "summary": "Add up every subscription, spot overlaps and see which ones to cancel and what you save.", "description": "List your subscriptions with price, billing cycle, category, how often you use them and how many people share them. Subscription Stack converts everything to monthly and yearly totals, groups by category, flags overlapping services, computes cost per use and lists cancellation candidates with the savings.\n\nMethodology:\n- Monthly price = weekly × (365.25/12)/7 (≈ 4.348), monthly × 1, quarterly ÷ 3, yearly ÷ 12.\n- Your share = monthly price ÷ number of people sharing; annual = your monthly share × 12.\n- Cost per use = your monthly share ÷ uses per month (not computed when uses are unknown or zero).\n- Overlap = two or more subscriptions in the same category (excluding “other”).\n- Cancel candidate if uses per month < your threshold, or cost per use > your threshold, or it is the most expensive per use (or least used) service within an overlapping category.\n- Savings if cancelled = sum of your monthly shares of all candidates; annual = × 12.", "tags": [ "money" ], "x-mcp-tool": "subscription_stack", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriptionStackInput" }, "examples": { "example1": { "summary": "Typical household stack", "value": { "currency": "EUR", "minUsesPerMonth": 2, "maxCostPerUse": 5, "subscriptions": [ { "name": "Netflix", "price": 13.99, "billing": "monthly", "category": "video", "usesPerMonth": 12, "sharedBy": 2 }, { "name": "Disney+", "price": 89.9, "billing": "yearly", "category": "video", "usesPerMonth": 2 }, { "name": "Spotify", "price": 10.99, "billing": "monthly", "category": "music", "usesPerMonth": 40 }, { "name": "Gym", "price": 34.9, "billing": "monthly", "category": "fitness", "usesPerMonth": 3 }, { "name": "Cloud 2 TB", "price": 9.99, "billing": "monthly", "category": "cloud-storage", "usesPerMonth": 30 }, { "name": "Newspaper", "price": 29.97, "billing": "quarterly", "category": "news", "usesPerMonth": 1 } ] } }, "example2": { "summary": "Freelancer software stack", "value": { "currency": "USD", "minUsesPerMonth": 4, "maxCostPerUse": 3, "subscriptions": [ { "name": "Design suite", "price": 59.99, "billing": "monthly", "category": "software", "usesPerMonth": 20 }, { "name": "Second design app", "price": 99, "billing": "yearly", "category": "software", "usesPerMonth": 1 }, { "name": "Cloud backup", "price": 6, "billing": "monthly", "category": "cloud-storage", "usesPerMonth": 30 }, { "name": "Extra cloud drive", "price": 2.99, "billing": "monthly", "category": "cloud-storage" } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SubscriptionStackResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/travel-exchange-fee-calculator/calculate": { "post": { "operationId": "calculateTravelExchangeFeeCalculator", "summary": "Compare what cards, ATMs, DCC and exchange bureaus really cost abroad vs the ECB reference rate.", "description": "Enter what you spend abroad and the terms of your payment options – foreign transaction fee, exchange-rate mark-up, ATM fees, “pay in your currency” (dynamic currency conversion) and exchange-bureau spreads. The calculator converts at the ECB reference rate (or your own rate) and shows the effective rate, total cost and extra cost of each option, cheapest first.\n\nMethodology:\n- Reference cost = amount ÷ reference rate (the ECB euro reference rate, cross-calculated via EUR for non-euro pairs, or your manual rate).\n- Each option: cost at its own rate = reference cost × (1 + mark-up %); plus the percentage fee on that amount; plus fixed fees (ATM fixed fees × number of withdrawals). Effective rate = amount ÷ total cost; extra cost = total − reference cost.\n- Dynamic currency conversion (DCC, “pay in your currency”) means the shop’s or ATM operator’s provider converts instead of your card issuer; its mark-up is entered as a rate mark-up. Under Regulation (EU) 2019/518 DCC providers and card issuers in the EU must express their conversion charges as a mark-up over the latest ECB reference rate before you pay, which is the comparison this tool makes.\n- The default rows are illustrative example values, not market data. Replace them with your card’s published terms and the mark-up shown on the terminal or at the exchange counter.\n\nAn estimate: the rate your card network applies on the booking day and any fees not entered here change the final amount.", "tags": [ "money" ], "x-mcp-tool": "travel_exchange_fee_calculator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TravelExchangeFeeCalculatorInput" }, "examples": { "example1": { "summary": "500 USD with the example options (manual rate 1 EUR = 1.10 USD)", "value": { "amount": 500, "spendCurrency": "USD", "homeCurrency": "EUR", "rateSource": "manual", "manualRate": 1.1 } }, "example2": { "summary": "20,000 JPY, 2 ATM withdrawals (manual rate 1 GBP = 190 JPY)", "value": { "amount": 20000, "spendCurrency": "JPY", "homeCurrency": "GBP", "rateSource": "manual", "manualRate": 190, "atmWithdrawals": 2, "options": [ { "name": "Travel card", "method": "card", "feePercent": 0, "markupPercent": 0.4, "fixedFee": 0 }, { "name": "High-street bank ATM", "method": "atm", "feePercent": 2.99, "markupPercent": 0, "fixedFee": 1.5 }, { "name": "DCC offer at the ATM", "method": "dcc", "feePercent": 0, "markupPercent": 8, "fixedFee": 1.5 } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TravelExchangeFeeCalculatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/warranty-value-calculator/calculate": { "post": { "operationId": "calculateWarrantyValueCalculator", "summary": "Is the extended warranty worth it? Expected payout vs. price and break-even failure rate.", "description": "Enter the warranty price, how many years it covers, what is already covered by the legal or manufacturer warranty, a failure probability, repair cost, deductible and the chance a claim is approved. The calculator shows the expected payout, the expected net value and the failure rate at which the warranty would break even.\n\nMethodology:\n- Effective years = coverage years − years already covered by the legal/manufacturer warranty (floored at 0); during the overlap the extended warranty adds nothing for defects.\n- Payout per claim = min(average repair cost, item price) − deductible, floored at 0 (a repair costing more than the item is replaced instead).\n- Expected approved claims = effective years × annual failure probability × approval probability (at most one failure per year, years independent).\n- Expected payout = expected approved claims × payout per claim; expected net value = expected payout − warranty price.\n- Probability of at least one approved claim = 1 − (1 − p × a)^years, with p = annual failure probability and a = approval probability.\n- Break-even failure probability = warranty price ÷ (effective years × approval probability × payout per claim).\n- Verdict: worth it if net value > +10% of the warranty price, not worth it if < −10%, otherwise marginal.", "tags": [ "money" ], "x-mcp-tool": "warranty_value_calculator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WarrantyValueCalculatorInput" }, "examples": { "example1": { "summary": "TV: 3-year plan over a 2-year legal warranty", "value": { "currency": "EUR", "itemPrice": 900, "warrantyPrice": 99, "coverageYears": 3, "overlapYears": 2, "annualFailureProbabilityPercent": 5, "averageRepairCost": 300, "deductible": 0, "claimApprovalPercent": 80 } }, "example2": { "summary": "Phone: 2-year protection with deductible", "value": { "currency": "USD", "itemPrice": 1000, "warrantyPrice": 199, "coverageYears": 2, "overlapYears": 1, "annualFailureProbabilityPercent": 15, "averageRepairCost": 400, "deductible": 99, "claimApprovalPercent": 90 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WarrantyValueCalculatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/food-storage-guide/calculate": { "post": { "operationId": "calculateFoodStorageGuide", "summary": "How long is food safe in the fridge or freezer? Dates from the official FoodSafety.gov chart.", "description": "Choose a food and the date you stored or opened it. The guide shows the refrigerator and freezer limits exactly as published in the FoodSafety.gov Cold Food Storage Chart, the resulting dates, and whether the food is fine, should be used soon, or should be discarded.\n\nMethodology:\n- Storage limits are copied verbatim from the FoodSafety.gov Cold Food Storage Chart (refrigerator at 40°F (4°C) or below, freezer at 0°F (-18°C) or below).\n- Text periods are converted to days with 1 week = 7 days, 1 month = 30 days, 1 year = 365 days; \"use immediately after thawing\" = 0 days.\n- Dates = date stored + lower limit (use-by earliest) and + upper limit (use-by latest).\n- Status (refrigerator/pantry): fine before the lower limit; use-soon from the lower limit up to the upper limit (for single values: on the last day); discard after the upper limit.\n- Freezer: the chart says freezer times are for quality only and food kept continuously at 0°F (-18°C) or below can be kept indefinitely, so the status after the upper limit is \"quality-past\", not \"discard\".\n- Items the chart marks \"Do not freeze\", \"Does not freeze well\" or \"Not recommended\" get status not-recommended.\n\nWhen in doubt, throw it out. Times assume correct storage temperatures throughout.", "tags": [ "home-travel" ], "x-mcp-tool": "food_storage_guide", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FoodStorageGuideInput" }, "examples": { "example1": { "summary": "Leftover chicken cooked 3 days ago", "value": { "food": "leftover-meat-poultry", "storage": "fridge", "dateStored": "2026-10-09", "today": "2026-10-12" } }, "example2": { "summary": "Ground beef in the freezer since summer", "value": { "food": "ground-meat", "storage": "freezer", "dateStored": "2026-06-01", "today": "2026-10-12" } }, "example3": { "summary": "Opened deli meat after a week", "value": { "food": "luncheon-meat-opened", "storage": "fridge", "dateStored": "2026-10-05", "today": "2026-10-12" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FoodStorageGuideResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/household-chore-rotator/calculate": { "post": { "operationId": "calculateHouseholdChoreRotator", "summary": "Fair chore rotation by effort and availability, with per-person totals and a calendar.", "description": "List your recurring chores (daily, weekly, every two weeks or monthly) with how long they take, and who lives with you and on which days they are available. The rotator builds a calendar for up to 12 weeks that balances everyone's minutes (optionally weighted, e.g. half for a child), rotates who does what, shows per-person totals and exports an .ics calendar file.\n\nMethodology:\n- Occurrences: daily chores happen every day; weekly ones once a week on their day; every-2-weeks ones in weeks 1, 3, 5 …; monthly ones every 4 weeks (13 times a year) so they stay on the same weekday. Weeks are counted from the start date.\n- Weekly-type chores without a fixed day are placed on the weekday with the least planned effort so far (that someone is available on), and keep that day.\n- Occurrences are assigned longest chore first (then by date); each goes to an available person with the lowest score = (minutes already assigned + this chore) ÷ capacity + a rotation term of ¼ × chore minutes × (how often this person already did this chore − the least anyone available did it). Ties go to the person listed first. This keeps everyone's effort proportional to their capacity and rotates the chores.\n- Target share = capacity ÷ sum of capacities. Availability limits can make a perfect balance impossible; the totals table shows the actual shares.\n- The .ics file has one all-day event per chore and day (RFC 5545: CRLF line endings, folded lines, stable UIDs derived from the inputs, DTSTAMP = time of calculation).", "tags": [ "home-travel" ], "x-mcp-tool": "household_chore_rotator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HouseholdChoreRotatorInput" }, "examples": { "example1": { "summary": "Flat share of three, 4 weeks", "value": { "startDate": "2026-10-19", "weeks": 4, "chores": [ { "name": "Dishes", "frequency": "daily", "minutes": 15, "day": "any" }, { "name": "Vacuum living room", "frequency": "weekly", "minutes": 30, "day": "sat" }, { "name": "Clean bathroom", "frequency": "weekly", "minutes": 45, "day": "any" }, { "name": "Take out recycling", "frequency": "biweekly", "minutes": 10, "day": "tue" }, { "name": "Defrost freezer", "frequency": "monthly", "minutes": 60, "day": "sun" } ], "people": [ { "name": "Ana", "days": "" }, { "name": "Ben", "days": "Mon-Fri" }, { "name": "Chen", "days": "Wed-Sun" } ] } }, "example2": { "summary": "Family with a child at half capacity, 2 weeks", "value": { "startDate": "2026-11-02", "weeks": 2, "chores": [ { "name": "Set the table", "frequency": "daily", "minutes": 5, "day": "any" }, { "name": "Laundry", "frequency": "weekly", "minutes": 60, "day": "sat" }, { "name": "Water plants", "frequency": "weekly", "minutes": 10, "day": "wed" } ], "people": [ { "name": "Parent A", "capacity": 1 }, { "name": "Parent B", "capacity": 1 }, { "name": "Kid", "capacity": 0.5, "days": "Sat,Sun" } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HouseholdChoreRotatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/household-maintenance-calendar/calculate": { "post": { "operationId": "calculateHouseholdMaintenanceCalendar", "summary": "A dated home maintenance schedule for your appliances and features, as a calendar file.", "description": "Tick the features of your home — heating, alarms, appliances, gutters, garden, pool, car — and get a dated maintenance plan for up to 24 months, grouped by month, with safety intervals backed by official guidance and a recurring-event calendar file to import.\n\nMethodology:\n- Tasks come from an editorial catalog of generic maintenance best practice; a task is included if it applies to every home, to your home type, or to a feature you ticked.\n- Interval tasks (every N months): the first date is the start date for monthly tasks, and start date + (catalog position × 3 mod 28) days for longer intervals so that work is spread out; then every N months. A first date on the 29th–31st moves to the 28th of the following month so the calendar recurrence is valid in every month.\n- Day-interval tasks (e.g. weekly pool checks) repeat every N days from the start date.\n- Seasonal tasks fall on the 1st of their months (northern hemisphere months; +6 months in the southern hemisphere).\n- Only dates from the start date to the day before start + N months are listed. The .ics file has one all-day recurring VEVENT per task (RRULE FREQ=MONTHLY/DAILY/YEARLY with UNTIL), CRLF line endings, folded lines and UIDs derived from the inputs.\n- Safety intervals (smoke and CO alarm tests and batteries, chimney inspection, septic inspection, tyre pressure) follow the cited official guidance; all other intervals are editorial — your manufacturer’s manual takes precedence.\n\nGeneric reminders, not a substitute for your appliance manuals, local regulations or professional inspections. Do not climb on roofs; hire professionals for gas, electrical and roof work.", "tags": [ "home-travel" ], "x-mcp-tool": "household_maintenance_calendar", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HouseholdMaintenanceCalendarInput" }, "examples": { "example1": { "summary": "Apartment, 12 months", "value": { "homeType": "apartment", "features": [ "smoke-detectors", "co-detectors", "gas-heating", "dishwasher", "washing-machine", "fridge" ], "hemisphere": "north", "startDate": "2026-11-01", "months": 12 } }, "example2": { "summary": "House with garden, pool and car, 24 months", "value": { "homeType": "house", "features": [ "smoke-detectors", "heat-pump", "water-heater", "dryer", "gutters", "chimney", "garden", "pool", "septic", "solar", "car" ], "hemisphere": "north", "startDate": "2026-10-15", "months": 24 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HouseholdMaintenanceCalendarResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/jet-lag-planner/calculate": { "post": { "operationId": "calculateJetLagPlanner", "summary": "A day-by-day sleep, light and caffeine plan to beat jet lag, with calendar export.", "description": "Pick your home and destination time zones, travel date and usual sleep times. The planner computes the real time difference for that date (including daylight saving), shifts your sleep before departure, and lists when to seek or avoid bright light and when to stop caffeine until you are adapted. Download it as a calendar file.\n\nMethodology:\n- Time difference = destination UTC offset (at noon UTC on the arrival date) − home UTC offset (at noon UTC on the departure date), via the Intl time-zone database, so daylight saving is included. It is normalised to −12…+12 h; positive = eastward (clock must advance), negative = westward (delay).\n- Pre-flight: sleep and wake move 1 hour per day toward destination time (earlier for east, later for west), as suggested in the CDC Yellow Book jet-lag chapter for the 2–3 days before travel; days beyond what is needed are skipped.\n- After arrival you sleep on local time; the body clock is assumed to catch up 1 h/day after eastward and 1.5 h/day after westward travel (common planning rule of thumb, not an individual prediction).\n- Core body temperature minimum (CBTmin) is estimated at 2.5 h before the body’s habitual wake time (2 h for early birds, 3 h for night owls).\n- Light rule (phase-response curve): to advance (east) seek bright light in the 3 h after CBTmin and avoid it in the 3 h before; to delay (west) seek light in the 3 h before CBTmin and avoid it in the 3 h after. If a window falls while you sleep, use only its waking part.\n- Caffeine cut-off = 6 h before planned bedtime (CDC Yellow Book example).\n- The .ics file contains bedtime, light and caffeine events in UTC with UIDs derived from a hash of your inputs, CRLF line endings and folded lines.\n\nGeneral planning guidance, not medical advice. Ask a clinician before using melatonin or sleep medication.", "tags": [ "home-travel" ], "x-mcp-tool": "jet_lag_planner", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JetLagPlannerInput" }, "examples": { "example1": { "summary": "Berlin → New York (westward, 6 h)", "value": { "homeZone": "Europe/Berlin", "destinationZone": "America/New_York", "departureDate": "2026-11-10", "bedtime": "23:00", "wakeTime": "07:00", "daysBefore": 3, "chronotype": "intermediate" } }, "example2": { "summary": "London → Tokyo (eastward, 9 h)", "value": { "homeZone": "Europe/London", "destinationZone": "Asia/Tokyo", "departureDate": "2027-04-02", "arrivalDate": "2027-04-03", "bedtime": "23:30", "wakeTime": "07:30", "daysBefore": 3, "chronotype": "late" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JetLagPlannerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/leftover-chef/calculate": { "post": { "operationId": "calculateLeftoverChef", "summary": "Turn leftovers and fridge odds and ends into 5 recipe ideas, using what expires first.", "description": "List what is in your fridge and cupboard, mark what must be used soon, and set diet, equipment and time. Leftover Chef matches your ingredients against 37 flexible recipe templates (frittata, fried rice, soup, curry…) and ranks the five that use the most of what you have with the fewest missing items.\n\nMethodology:\n- Each ingredient line is normalised: lower-cased, quantities/units and words like \"leftover\", \"fresh\", \"chopped\" removed, plurals singularised, synonyms mapped (courgette → zucchini, garbanzo → chickpea…), then classified (vegetable, protein, grain, dairy…) with diet flags. \"Vegan …\", \"dairy-free …\", \"gluten-free …\" prefixes clear the matching flags.\n- Templates are editorial: each has core requirements (one of several alternatives), flexible slots (e.g. 1–4 vegetables, optional cheese), equipment alternatives and a total time. Salt, pepper, cooking oil, water and dried spices are assumed available.\n- A template is eligible if its time ≤ your maximum, you have one of its equipment options, every unmet core requirement still has a diet-compatible alternative, at least one of your ingredients is used and at most 3 items are missing.\n- Core requirements are filled first, then slots; use-soon items are always tried first and each ingredient is used once per recipe.\n- Score = 50 × share of core requirements you have + 30 × share of your use-soon items used + 3 × core requirements you have + 4 × number of your ingredients used (max 8) − 12 × missing items. Ties: fewer missing, shorter time, then template id.\n\nGeneric cooking templates, not tested recipes. Check that leftovers are still safe to eat and cook meat, fish and eggs thoroughly.", "tags": [ "home-travel" ], "x-mcp-tool": "leftover_chef", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeftoverChefInput" }, "examples": { "example1": { "summary": "Eggs, rice and wilting veg", "value": { "ingredients": [ "4 eggs", "leftover rice", "half a courgette", "spinach", "cheddar", "spring onions", "soy sauce" ], "useSoon": [ "spinach", "courgette" ], "equipment": [ "stove", "oven" ], "maxMinutes": 30 } }, "example2": { "summary": "Vegan pantry dinner", "value": { "ingredients": [ "chickpeas", "tinned tomatoes", "onion", "garlic", "coconut milk", "curry paste", "rice", "sweet potato", "kale" ], "useSoon": [ "kale" ], "diet": [ "vegan" ], "equipment": [ "stove", "oven" ], "maxMinutes": 45 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeftoverChefResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/moving-box-planner/calculate": { "post": { "operationId": "calculateMovingBoxPlanner", "summary": "How many moving boxes, how much tape, which truck and when to start packing.", "description": "List your rooms and how much stuff you own. The planner estimates boxes by size, packing supplies, load volume, a suitable truck class, crew size and hours, optional cost, and a packing schedule counting back from moving day. All counts are transparent rules of thumb you can check.\n\nMethodology:\n- Boxes per room = editorial base count for a medium room at average density × room size factor (small 0.7, medium 1, large 1.4) × stuff factor (minimalist 0.7, average 1, collector 1.4), rounded up per box type. One extra wardrobe box per person for hanging clothes.\n- Box sizes: small 40×30×30 cm (0.036 m³, books/heavy), medium 50×40×40 cm (0.08 m³), large 60×45×45 cm (0.1215 m³, light/bulky), wardrobe 50×50×120 cm (0.3 m³).\n- Furniture allowance per room (medium): bedroom 4, living 6, kitchen 2, bathroom 0.3, office 2.5, kids 3, garage 3, storage 1.5 m³, scaled by room size and stuff factor. Load volume = (boxes + furniture) × 1.15 for imperfect stacking.\n- Truck: smallest vehicle class whose nominal volume ≥ load (panel van 12, Luton 20, 7.5 t 35, 12 t 50, 18 t 70 m³); larger loads need multiple trips of the 18 t class.\n- Crew: 2 people up to 20 m³, 3 up to 40 m³, 4 above. Loading and unloading each at 2.5 m³ per person-hour, +10% per floor without elevator; driving at 60 km/h average one way.\n- Supplies: 3 m of tape per box on 50 m rolls (+1 spare roll), packing paper and bubble wrap per box by room type (kitchen and living highest), 1 marker per 2 people (min 2).\n- Packing pace: 10 boxes per day; rooms are packed in the order storage → garage → office → kids → living → bedroom → bathroom → kitchen, finishing the day before the move.\n\nRules of thumb, not a quote. Professional movers survey your home for a binding estimate.", "tags": [ "home-travel" ], "x-mcp-tool": "moving_box_planner", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MovingBoxPlannerInput" }, "examples": { "example1": { "summary": "2-bedroom flat, couple", "value": { "rooms": [ { "type": "bedroom", "size": "medium" }, { "type": "bedroom", "size": "small" }, { "type": "living", "size": "medium" }, { "type": "kitchen", "size": "medium" }, { "type": "bathroom", "size": "small" } ], "people": 2, "density": "average", "distanceKm": 15, "floorsWithoutElevator": 3, "moveDate": "2026-11-28", "currency": "EUR" } }, "example2": { "summary": "Family house with movers", "value": { "rooms": [ { "type": "bedroom", "size": "large" }, { "type": "kids", "size": "medium" }, { "type": "kids", "size": "medium" }, { "type": "living", "size": "large" }, { "type": "kitchen", "size": "large" }, { "type": "office", "size": "medium" }, { "type": "bathroom", "size": "medium" }, { "type": "garage", "size": "medium" } ], "people": 4, "density": "collector", "distanceKm": 250, "floorsWithoutElevator": 1, "moveDate": "2027-03-15", "moverHourlyRate": 45, "truckHourlyRate": 30, "currency": "EUR" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MovingBoxPlannerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/room-layout-optimizer/calculate": { "post": { "operationId": "calculateRoomLayoutOptimizer", "summary": "Auto-arrange furniture in a room around doors, windows and a clear walkway.", "description": "Give the room size, doors, windows and your furniture with the clearance each piece needs. A deterministic grid search places everything inside the room without overlaps, keeps door swings and a walkway clear, prefers walls and windows where requested and returns coordinates plus a text floor plan.\n\nMethodology:\n- The room is rasterised into grid cells (default 10 cm); furniture sizes, clearances and door zones are rounded up to whole cells, the room size down.\n- Each door gets a keep-clear square (door width × door width) inside the room in front of it, approximating the quarter-circle swing.\n- Each item can face any of the 4 directions; its body must lie inside the room and not overlap other bodies, other clearance zones or door squares; its front clearance zone must lie inside the room and not overlap bodies. \"Back against wall\" items must touch the wall behind them.\n- Walkway: the free floor is eroded by a square of the walkway width; squares connected to a door square form the reachable walkway. Every item’s clearance zone (or the cell strip in front of it) must touch that walkway.\n- Search: items are placed largest-area first with a beam search (4 partial layouts kept). For each layout, every valid grid position is pre-scored (wall hugging, corner use, distance to the nearest window for \"prefer near window\" items); the 25 best are checked for walkway access and scored.\n- Score = 1000 × items placed + 10 × reachable walkway m² + 2 per wall item in a corner − 3 × distance (m) of free-standing items from the nearest wall − 5 × distance (m) from window-loving items to the nearest window. Ties break by input order, then north-to-south, west-to-east position.\n\nRectangles only; radiators, sockets, sloped ceilings and personal taste are not considered. Treat the result as a starting point.", "tags": [ "home-travel" ], "x-mcp-tool": "room_layout_optimizer", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoomLayoutOptimizerInput" }, "examples": { "example1": { "summary": "Bedroom with desk by the window", "value": { "roomWidth": 400, "roomDepth": 350, "gridCm": 10, "walkwayCm": 60, "openings": [ { "kind": "door", "wall": "south", "offset": 20, "width": 80 }, { "kind": "window", "wall": "north", "offset": 150, "width": 120 } ], "furniture": [ { "name": "Double bed", "width": 160, "depth": 200, "needsWall": true, "clearanceFront": 60, "nearWindow": false }, { "name": "Wardrobe", "width": 150, "depth": 60, "needsWall": true, "clearanceFront": 70, "nearWindow": false }, { "name": "Desk", "width": 120, "depth": 60, "needsWall": true, "clearanceFront": 70, "nearWindow": true } ] } }, "example2": { "summary": "Living room", "value": { "roomWidth": 500, "roomDepth": 420, "gridCm": 10, "walkwayCm": 70, "openings": [ { "kind": "door", "wall": "west", "offset": 30, "width": 90 }, { "kind": "window", "wall": "east", "offset": 120, "width": 180 } ], "furniture": [ { "name": "Sofa", "width": 220, "depth": 95, "needsWall": true, "clearanceFront": 80, "nearWindow": false }, { "name": "TV unit", "width": 180, "depth": 45, "needsWall": true, "clearanceFront": 50, "nearWindow": false }, { "name": "Armchair", "width": 85, "depth": 85, "needsWall": false, "clearanceFront": 50, "nearWindow": true }, { "name": "Bookshelf", "width": 100, "depth": 35, "needsWall": true, "clearanceFront": 50, "nearWindow": false } ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoomLayoutOptimizerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/travel-connection-checker/calculate": { "post": { "operationId": "calculateTravelConnectionChecker", "summary": "Estimate your odds of making a flight connection, step by step.", "description": "Enter your arrival and onward departure times and what you have to do in between (terminal change, passport control, security, baggage). The checker adds up transparent time ranges for each step, compares them with your connection time and estimates the chance of making it under a simple inbound-delay model. It is an estimate, never a guarantee.\n\nMethodology:\n- Available time = scheduled departure − scheduled arrival − gate-closure minutes.\n- Required time = deplaning + walking (+ terminal change) + optional immigration, security and baggage re-check, each an editorial [best, typical, worst] range by airport size; walking and terminal transfer are multiplied by 1.4 (slow) / 1.0 / 0.8 (fast).\n- Buffer = available − required, for each of best/typical/worst.\n- Inbound delay model: on time with probability p, otherwise delay ~ Exponential(mean delay). P(miss) = (1 − p)·e^(−buffer/mean) if buffer ≥ 0, else 100%. P(make) = 1 − P(miss). Early arrivals and onward-flight delays are ignored (both would help).\n- Overall chance: total processing time is treated as a triangular distribution between the best, typical and worst totals, and P(make) is averaged over it numerically (400 slices). The best/worst columns show the chance if processing is at its fastest/slowest.\n- Verdict from the overall chance: ≥ 95% comfortable, ≥ 85% ok, ≥ 70% tight, ≥ 50% risky, below that very risky.\n\nA planning estimate from simplified assumptions — not a guarantee. Airline, airport and border procedures and queues vary widely.", "tags": [ "home-travel" ], "x-mcp-tool": "travel_connection_checker", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TravelConnectionCheckerInput" }, "examples": { "example1": { "summary": "Schengen → non-Schengen at a large hub, 70 min", "value": { "arrival": "2026-11-03T09:40", "departure": "2026-11-03T10:50", "terminalChange": true, "immigration": true, "securityRecheck": false, "baggageRecheck": false, "airportSize": "large", "walkingSpeed": "average", "gateClosesMinutes": 15, "onTimeProbability": 75, "meanDelayMinutes": 35, "officialMct": 50 } }, "example2": { "summary": "US arrival with baggage recheck, 2 h 30", "value": { "arrival": "2026-12-18T14:05", "departure": "2026-12-18T16:35", "terminalChange": true, "immigration": true, "securityRecheck": true, "baggageRecheck": true, "airportSize": "mega", "walkingSpeed": "slow", "gateClosesMinutes": 15, "onTimeProbability": 75, "meanDelayMinutes": 35 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TravelConnectionCheckerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/weekly-meal-planner/calculate": { "post": { "operationId": "calculateWeeklyMealPlanner", "summary": "Turn your pantry and its expiry dates into a 7-day dinner plan and a shopping list.", "description": "List what is in your fridge and cupboards (with quantities and best-before dates) and your preferences (vegetarian, vegan, pescatarian, maximum cooking time, ingredients to avoid). The planner picks one dinner per day from about 60 simple home-cooking recipes, using food that expires soonest first, and adds up a shopping list of everything still missing.\n\nMethodology:\n- Recipes come from a bundled editorial dataset of about 60 simple home-cooking dinners with ingredient quantities, cooking time and diet. Quantities are scaled linearly to the number of people.\n- Recipes are filtered by diet (vegan ⊂ vegetarian ⊂ pescatarian ⊂ everything), maximum cooking time and the ingredients to avoid.\n- Pantry names are matched to recipe ingredients after normalising plurals and common synonyms (e.g. eggs → egg, courgette → zucchini, spaghetti → pasta). kg and l are converted to g and ml.\n- Day by day, every remaining recipe gets a score: for each ingredient, the share covered by the pantry × an urgency weight (expires within 1 day: 6, 3 days: 4, 7 days: 2, later: 1, no date: 0.5) × 10, plus the share of that pantry item used up × urgency × 5, minus 3 for every ingredient that must be bought. The highest score wins (ties: dataset order); the pantry is then reduced by what the recipe uses.\n- Items past their best-before date on the cooking day are not used. A recipe is repeated only when every eligible recipe has already been planned.\n- The shopping list adds up all missing amounts per ingredient (pieces rounded up to whole pieces). Salt, pepper, cooking oil and water are assumed to be at home.", "tags": [ "home-travel" ], "x-mcp-tool": "weekly_meal_planner", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WeeklyMealPlannerInput" }, "examples": { "example1": { "summary": "Use up spinach, eggs and chicken this week", "value": { "startDate": "2026-10-19", "days": 7, "servings": 2, "diet": "any", "maxMinutes": 45, "pantry": [ { "item": "Spinach", "quantity": 250, "unit": "g", "expires": "2026-10-20" }, { "item": "Eggs", "quantity": 6, "unit": "pcs", "expires": "2026-10-28" }, { "item": "Chicken breast", "quantity": 300, "unit": "g", "expires": "2026-10-21" }, { "item": "Rice", "quantity": 1, "unit": "kg" }, { "item": "Onions", "quantity": 4, "unit": "pcs" }, { "item": "Canned tomatoes", "quantity": 800, "unit": "g" }, { "item": "Feta", "quantity": 200, "unit": "g", "expires": "2026-10-23" }, { "item": "Pasta", "quantity": 500, "unit": "g" } ] } }, "example2": { "summary": "Vegan, 5 days, max 30 minutes", "value": { "startDate": "2026-11-02", "days": 5, "servings": 3, "diet": "vegan", "maxMinutes": 30, "pantry": [ { "item": "Chickpeas", "quantity": 800, "unit": "g" }, { "item": "Broccoli", "quantity": 400, "unit": "g", "expires": "2026-11-04" }, { "item": "Tofu", "quantity": 400, "unit": "g", "expires": "2026-11-05" }, { "item": "Rice", "quantity": 500, "unit": "g" } ], "exclude": [ "mushrooms" ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WeeklyMealPlannerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/will-it-fit/calculate": { "post": { "operationId": "calculateWillItFit", "summary": "Check if a sofa, wardrobe or box fits through doors, corners, stairs and lifts.", "description": "Enter the item’s length, width and height and the measurements along the delivery path. Will It Fit? tries every orientation, in-plane diagonal tilts and the classic moving-sofa corner calculation, then reports pass/fail per checkpoint with spare centimetres and how to carry the item.\n\nMethodology:\n- The item is treated as a rigid rectangular box; the safety clearance is subtracted from every opening dimension.\n- Doors, stairs and elevator doors: for each of the 3 choices of travel axis, the remaining two sides form the cross-section; it is rotated in the opening plane from 0° to 90° in 0.25° steps (bounding box p·cosθ+q·sinθ by p·sinθ+q·cosθ) and the best margin is kept — this covers the \"diagonal\" tilt through a door.\n- Corner: the classic moving-sofa formula for a right-angle turn between corridors of widths a and b gives the longest flat length L_max(w) = min over θ of a/sinθ + b/cosθ − w/(sinθ·cosθ), evaluated numerically in 0.05° steps.\n- Corner, 3D: every side may stand vertical if it fits under the ceiling; the item may also be tilted upward by φ (constant during the turn) so its plan length becomes L·cosφ + h·sinφ while L·sinφ + h·cosφ stays under the ceiling. Fixed-tilt is a conservative approximation of real manoeuvring.\n- Elevator cabin and room: one side stays horizontal while the other two stand in a vertical plane tilted by φ = 0…90° (1° steps): height p·sinφ + q·cosφ must fit under the ceiling and the footprint (p·cosφ + q·sinφ) × side is rotated on the floor (0.25° steps) to fit the plan — this covers upright placement, standing diagonally in the cabin and leaning.\n- Stairs are modelled as an opening of stair width × headroom; landings and turns of the stairwell are not modelled.\n\nGeometric estimate for rigid boxes. Real items have legs, curves and soft parts; real people need grip room. Measure twice.", "tags": [ "home-travel" ], "x-mcp-tool": "will_it_fit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WillItFitInput" }, "examples": { "example1": { "summary": "3-seat sofa through a flat door and corridor", "value": { "itemLength": 210, "itemWidth": 90, "itemHeight": 85, "clearance": 2, "doorWidth": 80, "doorHeight": 200, "hallwayWidthBefore": 100, "hallwayWidthAfter": 100, "ceilingHeight": 250, "roomWidth": 400, "roomDepth": 350, "roomHeight": 250 } }, "example2": { "summary": "Wardrobe box via elevator and stairs", "value": { "itemLength": 200, "itemWidth": 60, "itemHeight": 50, "clearance": 3, "doorWidth": 76, "doorHeight": 198, "ceilingHeight": 250, "stairsWidth": 90, "stairsHeadroom": 200, "elevatorDoorWidth": 80, "elevatorDoorHeight": 200, "elevatorCabinWidth": 110, "elevatorCabinDepth": 140, "elevatorCabinHeight": 210 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WillItFitResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/ai-answer-verifier/calculate": { "post": { "operationId": "calculateAiAnswerVerifier", "summary": "Split an AI answer into claims and see which ones your sources actually support.", "description": "Paste an AI-generated answer and the sources it should be based on (text or public URLs). Each sentence becomes a claim; check-worthy claims (numbers, dates, names, superlatives, causes) are flagged, and every claim is matched to the best-supporting source sentence with BM25 scoring and number checks.\n\nMethodology:\n- Claims = sentences of the answer with at least 15 characters.\n- Check-worthy if the claim contains numbers, years, multi-word proper names, superlatives/absolutes or causal wording.\n- Each source is split into sentences; the best match for a claim is the source sentence with the highest BM25 score (k1 = 1.2, b = 0.75) over content words.\n- Coverage = share of the claim's distinct content words found in that sentence. supported: coverage ≥ 0.7 and every number in the claim appears in it; partially-supported: coverage ≥ 0.4; contradicted-number: coverage ≥ 0.5, a number from the claim is missing from the evidence and the evidence contains a different number; otherwise not-found.\n\nThis is lexical evidence matching, not truth verification: \"supported\" means similar wording exists in your sources, not that the sources are right. Paraphrases can be missed.", "tags": [ "internet" ], "x-mcp-tool": "ai_answer_verifier", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiAnswerVerifierInput" }, "examples": { "example1": { "summary": "Eiffel Tower facts", "value": { "answer": "The Eiffel Tower was completed in 1889 for the World's Fair in Paris. It is 330 metres tall. It was designed by Gustave Eiffel alone. It is the most visited paid monument in the world.", "sources": "The Eiffel Tower was built for the 1889 World's Fair in Paris and completed in March 1889.\nIt is 330 metres (1,083 ft) tall, including antennas.\n---\nThe tower was designed by the engineers Maurice Koechlin and Émile Nouguier of Gustave Eiffel's company." } }, "example2": { "summary": "Wrong number", "value": { "answer": "The company reported revenue of 12 billion euros in 2025.", "sources": "In 2025 the company reported revenue of 9.4 billion euros, up 3% from the previous year." } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AiAnswerVerifierResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/error-message-translator/calculate": { "post": { "operationId": "calculateErrorMessageTranslator", "summary": "Paste a technical error and get the plain-English cause and troubleshooting steps.", "description": "Matches your error message against a database of over 120 known errors (HTTP status codes, TLS/certificate, DNS, network, filesystem, Node.js, Python, Java, npm, pip, git, Docker, SQL and Windows codes), explains the cause in plain English and fills the concrete file, host, port or package from your message into the steps.\n\nMethodology:\n- Every pattern is a regular expression with a specificity score from 1 (generic, e.g. \"permission denied\") to 10 (one exact error code).\n- All matching patterns are ranked by specificity, then by how early in the message they match; the top one is explained, the rest are listed.\n- If you pick a context, patterns from matching categories get +2 specificity when ranking.\n- Concrete values (URL, host, port, path, module, package, status/error code) are extracted from the message and inserted into the steps.\n- No match → generic triage steps; nothing is guessed.", "tags": [ "internet" ], "x-mcp-tool": "error_message_translator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorMessageTranslatorInput" }, "examples": { "example1": { "summary": "Database refused connection", "value": { "message": "Error: connect ECONNREFUSED 127.0.0.1:5432\n at TCPConnectWrap.afterConnect [as oncomplete] (node:net:1555:16)", "context": "code" } }, "example2": { "summary": "Python missing module", "value": { "message": "Traceback (most recent call last):\n File \"app.py\", line 1, in \n import requests\nModuleNotFoundError: No module named 'requests'", "context": "terminal" } }, "example3": { "summary": "Browser 502", "value": { "message": "502 Bad Gateway nginx/1.24.0", "context": "browser" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorMessageTranslatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/file-format-doctor/calculate": { "post": { "operationId": "calculateFileFormatDoctor", "summary": "Find out what a file really is from its bytes, why it will not open and how to convert it.", "description": "Upload a file (or paste its first bytes as hex) and the doctor reads its magic number against a table of 74 formats, looks inside ZIP containers (DOCX, XLSX, ODT, EPUB, JAR, APK), and diagnoses wrong extensions, truncated or encrypted files, text encoding problems and disguised executables — with offline conversion commands.\n\nMethodology:\n- Magic numbers are matched at their documented offsets for 74 formats (e.g. \"%PDF-\" at 0, \"ustar\" at 257, \"CD001\" at 0x8001, \"ftyp\" brands at 4).\n- ISO-BMFF files are told apart by their ftyp brands (heic/heix → HEIC, mif1 → HEIF, avif → AVIF, qt → QuickTime, M4A → audio, isom/mp42 → MP4).\n- ZIP files are opened by reading the central directory (or local file headers in a sample): [Content_Types].xml + word/ → DOCX, xl/ → XLSX, ppt/ → PPTX, the stored \"mimetype\" entry → ODT/ODS/ODP/EPUB, AndroidManifest.xml → APK, META-INF/MANIFEST.MF → JAR. General-purpose bit 0 marks encrypted entries.\n- Without a binary signature the bytes are checked for BOMs, UTF-16 patterns, strict UTF-8 validity and typical mojibake sequences (e.g. \"é\", \"’\"), then for SVG/HTML/XML/JSON/CSV structure.\n- Truncation checks (uploads only): PDF must end with %%EOF, PNG with IEND, JPEG with FF D9, GIF with 3B, ZIP must have an end-of-central-directory record, RIFF/BMP declared sizes must fit.\n- Conversion suggestions use free, offline tools (LibreOffice, ImageMagick, FFmpeg, 7-Zip, iconv) with the exact command for your file name.\n\nDetection reads bytes only; it does not scan for malware. Never run an executable you did not expect to receive.", "tags": [ "internet" ], "x-mcp-tool": "file_format_doctor", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileFormatDoctorInput" }, "examples": { "example1": { "summary": "iPhone photo renamed to .jpg (HEIC inside)", "value": { "filename": "IMG_0420.jpg", "hexBytes": "00 00 00 18 66 74 79 70 68 65 69 63 00 00 00 00 6d 69 66 31 68 65 69 63" } }, "example2": { "summary": "Invoice that is really a Windows program", "value": { "filename": "invoice_2026.pdf.exe", "hexBytes": "4D 5A 90 00 03 00 00 00 04 00 00 00 FF FF 00 00 B8 00 00 00 00 00 00 00 40 00 00 00 00 00 00 00" } }, "example3": { "summary": "Word document (ZIP local header with word/ entry)", "value": { "filename": "contract.zip", "hexBytes": "50 4B 03 04 14 00 00 00 08 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 11 00 00 00 77 6F 72 64 2F 64 6F 63 75 6D 65 6E 74 2E 78 6D 6C" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileFormatDoctorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/privacy-policy-decoder/calculate": { "post": { "operationId": "calculatePrivacyPolicyDecoder", "summary": "What a privacy policy says it collects, shares, sells and keeps — with quoted evidence.", "description": "Give the URL of a privacy policy or paste/upload its text (English or German). The decoder lists which data categories, purposes, sharing and sale practices, retention periods, user rights, laws (GDPR, CCPA/CPRA …), international transfer mechanisms and contacts the policy mentions, quotes the sentences, and points out topics it does not mention.\n\nMethodology:\n- The policy is split into sentences; every sentence is tested against fixed English and German keyword patterns for 7 sections: data collected, purposes, sharing & selling, rights, laws, international transfers and contact.\n- An item is \"mentioned\" when at least one sentence matches; up to 3 matching sentences are quoted. If every matching sentence contains a negation (\"we do not\", \"nicht\", \"keine\"), the item is marked as negated.\n- Sale of data is classified from sentences with sell/sale/verkaufen: negated sentences count as \"does not sell\", others as \"sells or may sell\"; both present = \"mixed statements\".\n- Retention periods are durations (e.g. \"7 years\", \"nach 7 Tagen\") found in sentences about retaining, storing or deleting data; open-ended phrases like \"as long as necessary\" are flagged as vague.\n- Children's age thresholds are numbers in phrases like \"under the age of 13\" / \"unter 16 Jahren\". \"Not mentioned\" means no pattern matched — not that the practice does not happen.\n\nRule-based keyword analysis of the policy text, not legal advice and not a compliance audit. A policy can describe practices in wording these patterns miss, and what a company does may differ from what its policy says.", "tags": [ "internet" ], "x-mcp-tool": "privacy_policy_decoder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrivacyPolicyDecoderInput" }, "examples": { "example1": { "summary": "App privacy policy (English)", "value": { "text": "Privacy Policy\nWe collect your name, email address and phone number when you register. We also collect your precise location, IP address and advertising ID, and we use cookies and tracking pixels.\nWe use your information to provide our services, for analytics and for personalized advertising. We may share your information with advertising partners and data brokers. We may sell your personal information; California residents can opt out via the \"Do Not Sell or Share My Personal Information\" link (CCPA/CPRA).\nWe retain your data for as long as necessary to provide our services. Payment records are kept for 7 years.\nYou have the right to access, delete and correct your personal information. Our services are not directed to children under the age of 13.\nYour data may be transferred to the United States under Standard Contractual Clauses.\nContact: privacy@example-app.com" } }, "example2": { "summary": "Datenschutzerklärung (Deutsch)", "value": { "text": "Datenschutzerklärung\nVerantwortlicher im Sinne der DSGVO ist die Beispiel GmbH. Unseren Datenschutzbeauftragten erreichen Sie unter datenschutz@beispiel.de.\nWir verarbeiten Ihre E-Mail-Adresse, Ihre Anschrift und Zahlungsdaten zur Vertragserfüllung. Beim Besuch unserer Website wird Ihre IP-Adresse gespeichert und nach 7 Tagen gelöscht.\nWir setzen Cookies nur mit Ihrer Einwilligung ein. Eine Weitergabe an Dritte erfolgt nur an Dienstleister im Rahmen der Auftragsverarbeitung. Wir verkaufen Ihre Daten nicht.\nRechnungsdaten bewahren wir aufgrund gesetzlicher Pflichten 10 Jahre auf.\nSie haben das Recht auf Auskunft, Berichtigung, Löschung, Einschränkung der Verarbeitung, Datenübertragbarkeit und Widerspruch. Sie können Ihre Einwilligung jederzeit widerrufen und sich bei einer Aufsichtsbehörde beschweren." } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrivacyPolicyDecoderResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/prompt-to-tool-router/calculate": { "post": { "operationId": "calculatePromptToToolRouter", "summary": "Describe your problem in plain words and get the right tools and order to use them.", "description": "Takes a natural-language request (English or German) and ranks the usefulweb.site tools and workflows that can solve it, using transparent keyword matching (TF-IDF with synonyms), and proposes a sequence of tool calls.\n\nMethodology:\n- The request is lower-cased, split into words, stop words (EN/DE) removed, lightly stemmed and expanded with a published synonym table.\n- Each tool is indexed by name (weight 3), keywords (2.5), id (2) and tagline (1.5); score = Σ weight × ln(1 + N/df) over matched terms, +4 per exact keyword phrase.\n- If a workflow scores at least 60% of the best tool score, its steps become the plan; otherwise the top tools are planned in score order.", "tags": [ "internet" ], "x-mcp-tool": "prompt_to_tool_router", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PromptToToolRouterInput" }, "examples": { "example1": { "summary": "Moving into a new apartment", "value": { "request": "I'm moving into a new apartment. Can you help me plan everything and avoid unnecessary expenses? Will my sofa fit through the door?" } }, "example2": { "summary": "Suspicious SMS", "value": { "request": "I got an SMS saying my parcel is held and I must pay a customs fee via a link. Is this a scam?" } }, "example3": { "summary": "Kündigung", "value": { "request": "Ich möchte mein Fitnessstudio-Abo kündigen und verstehen welche Fristen gelten" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PromptToToolRouterResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/scam-signal-checker/calculate": { "post": { "operationId": "calculateScamSignalChecker", "summary": "Check a message or link for common scam and phishing warning signs — without clicking.", "description": "Paste a suspicious e-mail, SMS or chat message and/or links (English or German). The checker looks for documented warning signs — urgency, threats, gift-card or crypto payment, requests for passwords or codes, lookalike and punycode domains, brand/domain mismatches, URL shorteners, risky attachments — and gives a weighted, explained score. Links are analysed statically and never opened. It never declares a message safe.\n\nMethodology:\n- Nothing is fetched or clicked: links are parsed as text (WHATWG URL parser) and compared with rules.\n- Each signal has a fixed weight; the score is the sum of the weights of the distinct signals found, capped at 100. Weights: urgency 15, threat 20, gift-card 30, crypto 25, wire 20, advance-fee 15, credentials 30, remote-access 25, prize 20, parcel-lure 10, generic-greeting 5, family-new-number 25, secrecy 10, investment 15, brand-domain-mismatch 30, lookalike-domain 35, punycode 25, shortener 10, ip-literal 25, at-in-url 25, display-mismatch 30, suspicious-tld 10, many-subdomains 10, no-https 10, sender-brand-mismatch 25, risky-attachment 30, double-extension 10.\n- Verdict: ≥ 50 \"high-risk signals\", 20–49 \"some warning signs\", 1–19 \"minor signals only\", 0 \"no common warning signs found\". No level means \"safe\" — scams without these patterns exist.\n- Brand checks use an editorial list of 67 frequently impersonated brands and their main official domains: lookalikes are detected by homoglyph normalisation (0→o, 1→l, rn→m, Cyrillic letters …) and edit distance (1 for names ≥ 5 letters, 2 for ≥ 9); brand names inside other domains or paths count as brand/domain mismatch.\n- The suspicious-TLD list is a heuristic (.zip .mov .top .xyz .click .link .work .support .rest .fit .cfd .sbs .icu .buzz .cam .gq .ml .cf .ga .tk .monster .quest .lol .cyou .bond .shop .online .site .live .info .ru .su); plenty of legitimate sites use these endings, so the weight is low.\n- Language rules cover English and German phrasing (e.g. \"Ihr Konto wurde gesperrt\", \"Zollgebühr\", \"Paket\", \"Hallo Mama, das ist meine neue Nummer\"). Each signal quotes the sentence, URL or file name that triggered it.\n\nA low score never means a message is safe. This is a static pattern check, not a malware scan or a verdict on the sender. When in doubt, contact the company through its official app, website or phone number — never via links or numbers in the message.", "tags": [ "internet" ], "x-mcp-tool": "scam_signal_checker", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScamSignalCheckerInput" }, "examples": { "example1": { "summary": "German bank phishing e-mail", "value": { "message": "Sehr geehrter Kunde,\nIhr Konto wurde vorübergehend gesperrt. Bitte bestätigen Sie Ihre Zugangsdaten innerhalb von 24 Stunden, sonst wird Ihr Online-Banking dauerhaft deaktiviert.\nJetzt entsperren: http://sparkasse-sicherheit.konto-verifizierung.top/login\nIhre Sparkasse", "senderAddress": "service@sparkasse-kundenservice.info" } }, "example2": { "summary": "Parcel SMS with lookalike link", "value": { "message": "DHL: Your parcel could not be delivered. A redelivery fee of 1.99 EUR is due. Pay now: https://dhI-redelivery.com/track?id=8812", "urls": [ "https://xn--pypal-4ve.com/signin", "bit.ly/3xYzAbc" ], "attachments": [ "Sendungsdetails.pdf.exe" ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScamSignalCheckerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/screenshot-to-steps/calculate": { "post": { "operationId": "calculateScreenshotToSteps", "summary": "Turn a screenshot of an app or website into numbered steps for what you want to do.", "description": "Upload a screenshot (or paste the visible labels) and say what you want to achieve. The text on screen is read with OCR, each label is classified as button, input field, navigation, link, checkbox or heading with its position, and the elements relevant to your goal are turned into numbered instructions.\n\nMethodology:\n- OCR: tesseract (English) with word positions; words with confidence below 30 are dropped; words on one line are split into separate elements at gaps wider than 1.8× the text height.\n- Roles are assigned by rules: known action words → button; trailing colon or known field names → input field; short labels in the top 12% or known section names → navigation; URLs/\"forgot…\" → link; ☐/[ ] → checkbox; text 1.5× taller than median → heading.\n- Your goal is split into keywords and expanded with synonyms (e.g. password → security, login). Steps: open the best-matching navigation item (if no matching field is visible), fill visible input fields, tick relevant checkboxes, then click the primary button (Save/Continue/OK…).\n- Position is reported as a 3×3 grid region (top/middle/bottom × left/center/right).\n\nSteps are derived only from text visible in the screenshot; icons without labels and hidden menus cannot be seen. Never upload screenshots that show passwords or card numbers.", "tags": [ "internet" ], "x-mcp-tool": "screenshot_to_steps", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotToStepsInput" }, "examples": { "example1": { "summary": "Change password (labels pasted)", "value": { "goal": "Change my password", "uiText": "Account settings\nProfile\nSecurity\nNotifications\nCurrent password:\nNew password:\nConfirm password:\n[ ] Sign out of all other devices\nCancel\nSave" } }, "example2": { "summary": "Find the settings", "value": { "goal": "turn off notifications", "uiText": "Home\nSearch\nNotifications\nMessages\nSettings\nWhat is happening?\nPost" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScreenshotToStepsResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/website-change-explainer/calculate": { "post": { "operationId": "calculateWebsiteChangeExplainer", "summary": "Compare two versions of a page and see which changes matter: prices, terms, dates, links.", "description": "Give a \"before\" and an \"after\" version of a web page (fetch a URL now or paste saved HTML/text). The tool extracts readable blocks, title, meta description, headings, links, prices and dates, diffs them block by block and word by word, and ranks meaningful changes above noise like whitespace, tracking parameters, timestamps or copyright years.\n\nMethodology:\n- Each side is parsed (tolerant HTML tree builder; plain text is split into lines). Text is collected per block-level element (p, li, h1–h6, td, …); scripts, styles and navigation-less noise like are skipped.\n- Blocks are aligned with a longest-common-subsequence diff over whitespace-normalised text; adjacent removed/added blocks with ≥ 40 % word overlap (Dice) are paired as \"modified\" and diffed word by word.\n- A change is trivial when it disappears after masking whitespace/case, clock times, \"N minutes ago\", copyright years and long hex/random tokens; links differing only in tracking parameters (utm_*, gclid, fbclid, …) are trivial.\n- Meaningful categories and scores: price 100, legal/terms keyword 90, contact (email/phone) 75, link target 70, title 65, date 60, heading 55, other number 45, meta description 40, link removed/added 35/30, other text 20 (+ up to 15 for size). Changes are ranked by score, then document order.\n- Every change lists the rule ids and matched tokens that produced its category.\n\nRule-based comparison of static HTML. Pages that build content with JavaScript may show fewer blocks than a browser; always read the actual wording of legal changes.", "tags": [ "internet" ], "x-mcp-tool": "website_change_explainer", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebsiteChangeExplainerInput" }, "examples": { "example1": { "summary": "Pricing page: price rise, new auto-renewal clause, tracking link", "value": { "beforeContent": "Pricing – Acme Cloud\n

Pricing

Pro plan

Pro costs $12 per month per user.

Cancel anytime from your dashboard.

\n

Questions? Email sales@acme.example or call +1 555 010 2000.

\nTerms Start trial\n

© 2025 Acme Inc. Page generated at 10:15

", "afterContent": "Pricing – Acme Cloud\n

Pricing

Pro plan

Pro costs $15 per month per user.

Plans renew automatically each year; cancellation requires 30 days notice.

\n

Questions? Email sales@acme.example or call +1 555 010 2000.

\nTerms Start trial\n

Enterprise

Contact us for volume pricing.

\n

© 2026 Acme Inc. Page generated at 09:02

", "includeTrivial": true, "maxChanges": 50 } }, "example2": { "summary": "Plain-text policy: changed deadline", "value": { "beforeContent": "Returns policy\nYou can return items within 30 days of delivery.\nRefunds are issued within 14 days.\nLast reviewed: 2026-01-10", "afterContent": "Returns policy\nYou can return items within 14 days of delivery.\nRefunds are issued within 14 days.\nLast reviewed: 2026-09-01", "includeTrivial": false, "maxChanges": 20 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebsiteChangeExplainerResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/accessibility-fixer/calculate": { "post": { "operationId": "calculateAccessibilityFixer", "summary": "Turn WCAG 2.2 problems in your HTML into concrete code fixes, grouped by effort.", "description": "Paste HTML or enter a URL and get a fix list: for every detected accessibility problem the tool shows the offending element, a corrected version generated from it (alt text, labels, lang, names, heading levels, table headers…) and how much work it is. Placeholders that need human judgement are marked TODO, and a patch-style diff is included.\n\nMethodology:\n- Runs the same static rule set as Accessibility Snapshot (WCAG 2.2 mapping verified against the W3C Recommendation).\n- Each fix is generated from the actual element: the original start tag is re-serialised with the needed attribute added, changed or removed (e.g. alt, aria-label, lang, id +