{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"MAZZAROT API & MCP","version":"1.0.0","description":"Public, read-only gateway to real MAZZAROT catalog/configuration. Private customer operations are documented but disabled. No AI, billing, memory or repository access is implied."},"servers":[{"url":"/","description":"Same origin as this document"}],"tags":[{"name":"Public"},{"name":"Unavailable contracts"},{"name":"Discovery"},{"name":"MCP"}],"paths":{"/v1/capabilities":{"get":{"operationId":"mazzarot_get_capabilities","summary":"MAZZAROT capability status","description":"Discover which API features actually work. Private customer and live Builder capabilities are unavailable; never imply an unavailable action ran.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_get_capabilities","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"apiVersion":{"type":"string"},"mode":{"type":"string","const":"public-read-only"},"liveAiAvailable":{"type":"boolean","const":false},"privateRuntimeAvailable":{"type":"boolean","const":false},"publicOperations":{"type":"array","items":{"type":"string"}},"unavailableOperations":{"type":"array","items":{"type":"string"}}},"required":["apiVersion","mode","liveAiAvailable","privateRuntimeAvailable","publicOperations","unavailableOperations"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"apiVersion":"1.0.0","mode":"public-read-only","liveAiAvailable":false,"privateRuntimeAvailable":false,"publicOperations":["mazzarot_get_capabilities","mazzarot_list_companions","mazzarot_get_companion","mazzarot_list_plans","mazzarot_quote_subscription","mazzarot_get_power_policy","mazzarot_get_import_policy","mazzarot_get_builder_edition","mazzarot_get_music_link"],"unavailableOperations":["getAccount","listConversations","createConversation","sendMessage","listMemory","stageMemoryImport","listTasks","createTask","getPowerBalance","listPowerLedger","builder_list_projects","builder_list_files","builder_read_source","builder_scan_project","builder_generate_patch","builder_preview_diff","builder_save_safe_branch","builder_get_build_status","builder_get_preview","builder_get_audit_history"]},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/companions":{"get":{"operationId":"mazzarot_list_companions","summary":"List zodiac companions","description":"List the twelve zodiac guides and XIII with public descriptions and app links. This does not consult a live AI or read a personal zodiac profile.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_list_companions","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companions":{"type":"array","items":{"type":"object","properties":{"sign":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces","xiii"]},"name":{"type":"string"},"tagline":{"type":"string"},"guidance":{"type":"string"},"suggestedPrompt":{"type":"string"},"artworkUrl":{"type":"string","format":"uri"},"companionUrl":{"type":"string","format":"uri"},"liveAiAvailable":{"type":"boolean","const":false}},"required":["sign","name","tagline","guidance","suggestedPrompt","artworkUrl","companionUrl","liveAiAvailable"],"additionalProperties":false}}},"required":["companions"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"companions":[{"sign":"aries","name":"Aries","tagline":"Bolder thinking. Brighter you.","guidance":"Aries brings the spark. Balance it with a pause: what outcome matters, what can you test, and what would change your mind?","suggestedPrompt":"Help me choose one small action for today.","artworkUrl":"https://mazzarot-ai.pages.dev/art/aries-ram.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/aries","liveAiAvailable":false},{"sign":"taurus","name":"Taurus","tagline":"Steady power. Grounded growth.","guidance":"Build on your stability while staying open to a new approach.","suggestedPrompt":"Help me build a steady plan without getting stuck.","artworkUrl":"https://mazzarot-ai.pages.dev/art/taurus.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/taurus","liveAiAvailable":false},{"sign":"gemini","name":"Gemini","tagline":"Quick thinking. Brighter you.","guidance":"Consider a second perspective, then choose one idea to finish.","suggestedPrompt":"Help me focus my ideas and choose one to finish.","artworkUrl":"https://mazzarot-ai.pages.dev/art/gemini.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/gemini","liveAiAvailable":false},{"sign":"cancer","name":"Cancer","tagline":"Deeper care. Stronger you.","guidance":"Honor your feelings while protecting your time and boundaries.","suggestedPrompt":"Help me make space for my needs and set a kind boundary.","artworkUrl":"https://mazzarot-ai.pages.dev/art/cancer.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/cancer","liveAiAvailable":false},{"sign":"leo","name":"Leo","tagline":"Own your light. Lift others.","guidance":"Lead with warmth and make room for someone else to shine.","suggestedPrompt":"Help me express my ideas with confidence and warmth.","artworkUrl":"https://mazzarot-ai.pages.dev/art/leo.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/leo","liveAiAvailable":false},{"sign":"virgo","name":"Virgo","tagline":"Clear thinking. Meaningful progress.","guidance":"Choose the improvement that matters most, and define enough.","suggestedPrompt":"Help me simplify a task and decide when it is good enough.","artworkUrl":"https://mazzarot-ai.pages.dev/art/virgo.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/virgo","liveAiAvailable":false},{"sign":"libra","name":"Libra","tagline":"Find balance. Choose your way.","guidance":"Weigh your options without losing sight of your own needs.","suggestedPrompt":"Help me weigh two options and make a clear choice.","artworkUrl":"https://mazzarot-ai.pages.dev/art/libra.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/libra","liveAiAvailable":false},{"sign":"scorpio","name":"Scorpio","tagline":"Go deeper. Rise stronger.","guidance":"Look beneath the first reaction, then ground your insight in evidence.","suggestedPrompt":"Help me reflect on a difficult situation and choose a constructive step.","artworkUrl":"https://mazzarot-ai.pages.dev/art/scorpio.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/scorpio","liveAiAvailable":false},{"sign":"sagittarius","name":"Sagittarius","tagline":"Wider horizons. Bolder possibilities.","guidance":"Explore the bigger possibility, then choose a concrete next step.","suggestedPrompt":"Help me turn a big possibility into a practical first step.","artworkUrl":"https://mazzarot-ai.pages.dev/art/sagittarius.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/sagittarius","liveAiAvailable":false},{"sign":"capricorn","name":"Capricorn","tagline":"Clear ambition. Lasting progress.","guidance":"Make a realistic plan that includes rest as well as progress.","suggestedPrompt":"Help me create a realistic plan for an important goal.","artworkUrl":"https://mazzarot-ai.pages.dev/art/capricorn.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/capricorn","liveAiAvailable":false},{"sign":"aquarius","name":"Aquarius","tagline":"Fresh thinking. Human impact.","guidance":"Connect original thinking with one useful real-world experiment.","suggestedPrompt":"Help me turn an unusual idea into a useful experiment.","artworkUrl":"https://mazzarot-ai.pages.dev/art/aquarius.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/aquarius","liveAiAvailable":false},{"sign":"pisces","name":"Pisces","tagline":"Trust your depth. Find your flow.","guidance":"Listen to your intuition and pair it with one grounded action.","suggestedPrompt":"Help me turn a creative feeling into something I can make.","artworkUrl":"https://mazzarot-ai.pages.dev/art/pisces.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/pisces","liveAiAvailable":false},{"sign":"xiii","name":"XIII Elite","tagline":"Many perspectives. One clear direction.","guidance":"Consider the practical, emotional and long-term views before choosing.","suggestedPrompt":"Help me consider several perspectives on an important decision.","artworkUrl":"https://mazzarot-ai.pages.dev/art/xiii.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/xiii","liveAiAvailable":false}]},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/companions/{sign}":{"get":{"operationId":"mazzarot_get_companion","summary":"Get one companion","description":"Read public sign-specific guidance, art and a companion link. Guidance is a static reflection prompt, not a prediction or personalized AI answer.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_get_companion","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"parameters":[{"name":"sign","in":"path","required":true,"schema":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces","xiii"]}}],"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companion":{"type":"object","properties":{"sign":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces","xiii"]},"name":{"type":"string"},"tagline":{"type":"string"},"guidance":{"type":"string"},"suggestedPrompt":{"type":"string"},"artworkUrl":{"type":"string","format":"uri"},"companionUrl":{"type":"string","format":"uri"},"liveAiAvailable":{"type":"boolean","const":false}},"required":["sign","name","tagline","guidance","suggestedPrompt","artworkUrl","companionUrl","liveAiAvailable"],"additionalProperties":false}},"required":["companion"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"companion":{"sign":"aries","name":"Aries","tagline":"Bolder thinking. Brighter you.","guidance":"Aries brings the spark. Balance it with a pause: what outcome matters, what can you test, and what would change your mind?","suggestedPrompt":"Help me choose one small action for today.","artworkUrl":"https://mazzarot-ai.pages.dev/art/aries-ram.png","companionUrl":"https://mazzarot-ai.pages.dev/#companion/aries","liveAiAvailable":false}},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/plans":{"get":{"operationId":"mazzarot_list_plans","summary":"List planned subscriptions","description":"Read planned pricing from MAZZAROT product configuration. Checkout, paid entitlements and customer subscriptions are not connected.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_list_plans","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","const":"planned"},"checkoutAvailable":{"type":"boolean","const":false},"currency":{"type":"string","const":"USD"},"plans":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","enum":["preview","start","plus","pro","elite"]},"name":{"type":"string"},"launchMonthlyUsd":{"type":"number"},"monthlyUsd":{"type":"number"},"firstAnnualUsd":{"type":"number"},"annualUsd":{"type":"number"},"builder":{"type":"string"},"activeProjectLimit":{"type":["number","null"]},"features":{"type":"array","items":{"type":"string"}}},"required":["id","name","launchMonthlyUsd","monthlyUsd","firstAnnualUsd","annualUsd","builder","activeProjectLimit","features"],"additionalProperties":false}}},"required":["status","checkoutAvailable","currency","plans"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"status":"planned","checkoutAvailable":false,"currency":"USD","plans":[{"id":"preview","name":"MAZZAROT Preview","launchMonthlyUsd":0,"monthlyUsd":0,"firstAnnualUsd":0,"annualUsd":0,"builder":"Preview","activeProjectLimit":0,"features":["Limited sign experience","Local planning preview","No premium automation"]},{"id":"start","name":"MAZZAROT Start","launchMonthlyUsd":9.99,"monthlyUsd":14.99,"firstAnnualUsd":119,"annualUsd":149,"builder":"Builder Lite","activeProjectLimit":1,"features":["One zodiac companion","Basic memory when connected","Daily guidance, vision board, scanner","Hydration, basic timing","Very limited RPA","Builder Lite · 1 active project"]},{"id":"plus","name":"MAZZAROT Plus","launchMonthlyUsd":39,"monthlyUsd":59,"firstAnnualUsd":499,"annualUsd":590,"builder":"Builder","activeProjectLimit":null,"features":["Deeper memory","Larger weekly Power allowance","More RPA, scanner, vision boards","Timing Radar and Firefighter mix","Multiple Builder projects"]},{"id":"pro","name":"MAZZAROT Pro","launchMonthlyUsd":79,"monthlyUsd":119,"firstAnnualUsd":999,"annualUsd":1190,"builder":"Advanced Builder","activeProjectLimit":null,"features":["Larger memory and high Power allowance","Advanced RPA, research and Builder","Cycle Companion, Relationship Clarity","Sleep support, advanced Timing Radar","Advanced Firefighter"]},{"id":"elite","name":"MAZZAROT Elite 12+1","launchMonthlyUsd":149,"monthlyUsd":199,"firstAnnualUsd":1699,"annualUsd":1990,"builder":"Builder Pro","activeProjectLimit":null,"features":["Elite 12+1 balancing layer","Highest memory and RPA allowance","Priority and proactive assistance","Premium voice and music benefits","Deep ASTRA tools and Builder Pro"]}]},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/pricing/quote":{"post":{"operationId":"mazzarot_quote_subscription","summary":"Calculate illustrative subscription price","description":"Calculate one billing term from planned prices. Launch eligibility is a hypothetical input, not verified account eligibility. No payment, subscription or Power changes occur.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_quote_subscription","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"string","enum":["preview","start","plus","pro","elite"]},"cadence":{"type":"string","enum":["month","year"]},"term":{"type":"integer","minimum":1,"maximum":1200},"launchEligible":{"type":"boolean"}},"required":["plan","cadence","term","launchEligible"],"additionalProperties":false},"example":{"plan":"start","cadence":"month","term":1,"launchEligible":true}}}},"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","const":"illustrative"},"currency":{"type":"string","const":"USD"},"amountUsd":{"type":"number"},"plan":{"type":"string","enum":["preview","start","plus","pro","elite"]},"cadence":{"type":"string","enum":["month","year"]},"term":{"type":"number"},"checkoutAvailable":{"type":"boolean","const":false},"taxIncluded":{"type":"boolean","const":false}},"required":["status","currency","amountUsd","plan","cadence","term","checkoutAvailable","taxIncluded"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"status":"illustrative","currency":"USD","amountUsd":9.99,"plan":"start","cadence":"month","term":1,"checkoutAvailable":false,"taxIncluded":false},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/power/policy":{"get":{"operationId":"mazzarot_get_power_policy","summary":"Read Power policy","description":"Read planned weekly-first Power spending and top-up rules. Returns no customer balance, allowance or credit conversion; those remain unconfigured.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_get_power_policy","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string","const":"planned"},"spendOrder":{"type":"array","items":{"type":"string"}},"weeklyCarryOver":{"type":"boolean","const":false},"purchasedExpiry":{"type":"null"},"purchasedSurvivesCancellation":{"type":"boolean","const":true},"purchasedSurvivesPause":{"type":"boolean","const":true},"minimumTopUpUsd":{"type":"number"},"topUpPacksUsd":{"type":"array","items":{"type":"number"}},"conversion":{"type":"null"},"weeklyAllowances":{"type":"null"},"verifiedFreeFallback":{"type":"boolean","const":false}},"required":["status","spendOrder","weeklyCarryOver","purchasedExpiry","purchasedSurvivesCancellation","purchasedSurvivesPause","minimumTopUpUsd","topUpPacksUsd","conversion","weeklyAllowances","verifiedFreeFallback"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"status":"planned","spendOrder":["weekly_included","purchased_lifetime"],"weeklyCarryOver":false,"purchasedExpiry":null,"purchasedSurvivesCancellation":true,"purchasedSurvivesPause":true,"minimumTopUpUsd":5,"topUpPacksUsd":[5,10,25,50,100],"conversion":null,"weeklyAllowances":null,"verifiedFreeFallback":false},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/memory/import-policy":{"get":{"operationId":"mazzarot_get_import_policy","summary":"Read memory import policy","description":"Explain the existing browser-only import review and receipt workflow. Does not upload, parse, approve or persist personal files through the API.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_get_import_policy","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"processing":{"type":"string","const":"browser-local"},"maxFileBytes":{"type":"number"},"sources":{"type":"array","items":{"type":"string"}},"formats":{"type":"array","items":{"type":"string"}},"explicitReviewRequired":{"type":"boolean","const":true},"permissionsImportable":{"type":"boolean","const":false},"canonicalSaveAvailable":{"type":"boolean","const":false},"receiptStatus":{"type":"string","const":"reviewed_not_saved"}},"required":["processing","maxFileBytes","sources","formats","explicitReviewRequired","permissionsImportable","canonicalSaveAvailable","receiptStatus"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"processing":"browser-local","maxFileBytes":8388608,"sources":["chatgpt","claude","files"],"formats":["zip","json","txt","md"],"explicitReviewRequired":true,"permissionsImportable":false,"canonicalSaveAvailable":false,"receiptStatus":"reviewed_not_saved"},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/editions/{sign}":{"get":{"operationId":"mazzarot_get_builder_edition","summary":"Read sign-branded Builder edition","description":"Read public edition branding and live availability. Aries has an owner-review demo; no sign has connected repository or build execution. No source files or owner repositories are returned.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_get_builder_edition","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"parameters":[{"name":"sign","in":"path","required":true,"schema":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces","xiii"]}}],"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sign":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces","xiii"]},"title":{"type":"string"},"primaryColor":{"type":"string"},"accentColor":{"type":"string"},"background":{"type":"string"},"avatarUrl":{"type":"string","format":"uri"},"tone":{"type":"string"},"attribution":{"type":"string","const":"Powered by MAZZAROT"},"liveBuilderAvailable":{"type":"boolean","const":false},"rollout":{"type":"string","enum":["aries-review-demo","brief-only"]},"modes":{"type":"array","items":{"type":"string"}}},"required":["sign","title","primaryColor","accentColor","background","avatarUrl","tone","attribution","liveBuilderAvailable","rollout","modes"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"sign":"aries","title":"Aries Builder","primaryColor":"#ff492e","accentColor":"#efbd84","background":"#080607","avatarUrl":"https://mazzarot-ai.pages.dev/art/aries-ram.png","tone":"Aries brings the spark. Balance it with a pause: what outcome matters, what can you test, and what would change your mind?","attribution":"Powered by MAZZAROT","liveBuilderAvailable":false,"rollout":"aries-review-demo","modes":["Auto","Fast","Best quality","Save Power"]},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/music/links/{sign}":{"get":{"operationId":"mazzarot_get_music_link","summary":"Get zodiac music handoff link","description":"Return a sign-specific link to the separate music service. Does not open the service, send personal data, create music or make a purchase.","tags":["Public"],"security":[],"x-availability":"available","x-mcp-tool":"mazzarot_get_music_link","x-mcp-annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"parameters":[{"name":"sign","in":"path","required":true,"schema":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces","xiii"]}}],"responses":{"200":{"description":"Validated read-only result. Planned product capabilities remain explicitly labelled.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"additionalProperties":false,"properties":{"data":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"sign":{"type":"string","enum":["aries","taurus","gemini","cancer","leo","virgo","libra","scorpio","sagittarius","capricorn","aquarius","pisces","xiii"]},"url":{"type":"string","format":"uri"},"externalService":{"type":"boolean","const":true},"purchaseIncluded":{"type":"boolean","const":false}},"required":["sign","url","externalService","purchaseIncluded"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"data":{"sign":"aries","url":"https://laintely.com/music?source=mazzarot&campaign=zodiac-companion&sign=aries#crear","externalService":true,"purchaseIncluded":false},"meta":{"apiVersion":"1.0.0","requestId":"00000000-0000-4000-8000-000000000000","availability":"available"}}}}},"400":{"description":"Invalid fields, enum, query or malformed JSON.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Maximum request body is 16 KiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Expected application/json without content encoding.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Sanitized internal failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/me":{"get":{"operationId":"getAccount","summary":"Unavailable: getAccount","description":"Authenticated account identity; never browser-local profile. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: profile:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"profile:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/conversations":{"get":{"operationId":"listConversations","summary":"Unavailable: listConversations","description":"Tenant-bound conversation history with cursor pagination. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: conversations:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"conversations:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createConversation","summary":"Unavailable: createConversation","description":"Create an account-owned conversation; idempotency required. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: conversations:write.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"conversations:write","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/chat/messages":{"post":{"operationId":"sendMessage","summary":"Unavailable: sendMessage","description":"Live assistant response; consent, entitlement and cost reservation required. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: chat:write.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"chat:write","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/memory":{"get":{"operationId":"listMemory","summary":"Unavailable: listMemory","description":"Canonical approved memory only; cursor pagination. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: memory:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"memory:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/memory/imports":{"post":{"operationId":"stageMemoryImport","summary":"Unavailable: stageMemoryImport","description":"Explicit-consent import staging, provenance and review; never automatic approval. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: memory:write.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"memory:write","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tasks":{"get":{"operationId":"listTasks","summary":"Unavailable: listTasks","description":"Account-owned task list; not browser-local tasks. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: tasks:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"tasks:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"operationId":"createTask","summary":"Unavailable: createTask","description":"Create a tenant-bound task; idempotency required. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: tasks:write.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"tasks:write","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/power/balance":{"get":{"operationId":"getPowerBalance","summary":"Unavailable: getPowerBalance","description":"Real weekly/reserve balances from the canonical ledger. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: power:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"power:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/power/ledger":{"get":{"operationId":"listPowerLedger","summary":"Unavailable: listPowerLedger","description":"Account-scoped usage receipts, cursor-paginated. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: power:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"power:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/list_projects":{"post":{"operationId":"builder_list_projects","summary":"Unavailable: builder_list_projects","description":"Reserved list_projects contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/list_files":{"post":{"operationId":"builder_list_files","summary":"Unavailable: builder_list_files","description":"Reserved list_files contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/read_source":{"post":{"operationId":"builder_read_source","summary":"Unavailable: builder_read_source","description":"Reserved read_source contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/scan_project":{"post":{"operationId":"builder_scan_project","summary":"Unavailable: builder_scan_project","description":"Reserved scan_project contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:write.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:write","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/generate_patch":{"post":{"operationId":"builder_generate_patch","summary":"Unavailable: builder_generate_patch","description":"Reserved generate_patch contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:write.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:write","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/preview_diff":{"post":{"operationId":"builder_preview_diff","summary":"Unavailable: builder_preview_diff","description":"Reserved preview_diff contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/save_safe_branch":{"post":{"operationId":"builder_save_safe_branch","summary":"Unavailable: builder_save_safe_branch","description":"Reserved save_safe_branch contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:write.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:write","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/get_build_status":{"post":{"operationId":"builder_get_build_status","summary":"Unavailable: builder_get_build_status","description":"Reserved get_build_status contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/get_preview":{"post":{"operationId":"builder_get_preview","summary":"Unavailable: builder_get_preview","description":"Reserved get_preview contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/builder/operations/get_audit_history":{"post":{"operationId":"builder_get_audit_history","summary":"Unavailable: builder_get_audit_history","description":"Reserved get_audit_history contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates. This version always returns 503, even with an Authorization header. No request is executed or persisted. Future scope: builder:read.","tags":["Unavailable contracts"],"security":[],"x-availability":"unavailable","x-future-scope":"builder:read","x-mcp-exposed":false,"responses":{"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Method not allowed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Canonical authenticated runtime is not connected. Do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/health":{"get":{"operationId":"health","tags":["Discovery"],"summary":"Service health, not backend readiness","responses":{"200":{"description":"Public gateway up; private runtime unavailable."}}}},"/openapi.json":{"get":{"operationId":"openapi","tags":["Discovery"],"summary":"This OpenAPI 3.1 document","responses":{"200":{"description":"Machine-readable API contract."}}}},"/manifest.json":{"get":{"operationId":"manifest","tags":["Discovery"],"summary":"MAZZAROT-specific integration manifest, not an OAuth discovery document","responses":{"200":{"description":"Available tool schemas, relative endpoints and safety flags."}}}},"/mcp":{"post":{"operationId":"mcp","tags":["MCP"],"summary":"Official SDK Streamable HTTP endpoint","description":"Stateless JSON responses. Accept application/json and text/event-stream. SDK negotiates MCP protocol version. GET/SSE, session persistence, private tools and OAuth are not offered in this public release.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","integer"]},"method":{"type":"string"},"params":{"type":"object"}}}}}},"responses":{"200":{"description":"JSON-RPC result or protocol error; tool results include structuredContent."},"202":{"description":"Notification accepted without body."},"400":{"description":"Protocol validation error."},"403":{"description":"Origin or host rejected.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"406":{"description":"Required Accept types missing."},"413":{"description":"Body too large."},"415":{"description":"Unsupported content type."}}}}},"components":{"schemas":{"Error":{"type":"object","required":["error","meta"],"additionalProperties":false,"properties":{"error":{"type":"object","required":["code","message"],"additionalProperties":false,"properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","required":["requestId","apiVersion"],"additionalProperties":false,"properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"type":"string"}}}}},"Meta":{"type":"object","required":["requestId","apiVersion","availability"],"additionalProperties":false,"properties":{"requestId":{"type":"string","format":"uuid"},"apiVersion":{"type":"string"},"availability":{"const":"available"}}}}}}