DEVELOPER PREVIEW · v1.0.0

MAZZAROT
API & MCP

One read-only interface for 13 companion editions, product configuration and truthful capability discovery.

Working now: public catalog and policy reads, illustrative subscription quotes, MCP tools/resources/prompts.
Not connected: customer accounts, live AI, canonical memory, Power balances, payments, repository editing and build/deploy execution. No secret or account token is needed for this public interface.

Quick start

Use this site's origin as BASE_URL. All routes below are relative to it.

curl "$BASE_URL/v1/companions/aries"
curl "$BASE_URL/v1/pricing/quote" \
  -H 'Content-Type: application/json' \
  -d '{"plan":"start","cadence":"month","term":1,"launchEligible":true}'

REST success: {"data":{...},"meta":{"apiVersion":"1.0.0","requestId":"UUID","availability":"available"}}. Errors: {"error":{"code":"...","message":"..."},"meta":{...}}. Request IDs are also returned as X-Request-Id.

9 working public operations

MAZZAROT capability status

GET /v1/capabilities

Discover which API features actually work. Private customer and live Builder capabilities are unavailable; never imply an unavailable action ran.

MCP: mazzarot_get_capabilities

Input and example output
{}
{
  "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"
  ]
}

List zodiac companions

GET /v1/companions

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.

MCP: mazzarot_list_companions

Input and example output
{}
{
  "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
    }
  ]
}

Get one companion

GET /v1/companions/{sign}

Read public sign-specific guidance, art and a companion link. Guidance is a static reflection prompt, not a prediction or personalized AI answer.

MCP: mazzarot_get_companion

Input and example output
{
  "sign": "aries"
}
{
  "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
  }
}

List planned subscriptions

GET /v1/plans

Read planned pricing from MAZZAROT product configuration. Checkout, paid entitlements and customer subscriptions are not connected.

MCP: mazzarot_list_plans

Input and example output
{}
{
  "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"
      ]
    }
  ]
}

Calculate illustrative subscription price

POST /v1/pricing/quote

Calculate one billing term from planned prices. Launch eligibility is a hypothetical input, not verified account eligibility. No payment, subscription or Power changes occur.

MCP: mazzarot_quote_subscription

Input and example output
{
  "plan": "start",
  "cadence": "month",
  "term": 1,
  "launchEligible": true
}
{
  "status": "illustrative",
  "currency": "USD",
  "amountUsd": 9.99,
  "plan": "start",
  "cadence": "month",
  "term": 1,
  "checkoutAvailable": false,
  "taxIncluded": false
}

Read Power policy

GET /v1/power/policy

Read planned weekly-first Power spending and top-up rules. Returns no customer balance, allowance or credit conversion; those remain unconfigured.

MCP: mazzarot_get_power_policy

Input and example output
{}
{
  "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
}

Read memory import policy

GET /v1/memory/import-policy

Explain the existing browser-only import review and receipt workflow. Does not upload, parse, approve or persist personal files through the API.

MCP: mazzarot_get_import_policy

Input and example output
{}
{
  "processing": "browser-local",
  "maxFileBytes": 8388608,
  "sources": [
    "chatgpt",
    "claude",
    "files"
  ],
  "formats": [
    "zip",
    "json",
    "txt",
    "md"
  ],
  "explicitReviewRequired": true,
  "permissionsImportable": false,
  "canonicalSaveAvailable": false,
  "receiptStatus": "reviewed_not_saved"
}

Read sign-branded Builder edition

GET /v1/builder/editions/{sign}

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.

MCP: mazzarot_get_builder_edition

Input and example output
{
  "sign": "aries"
}
{
  "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"
  ]
}

Get zodiac music handoff link

GET /v1/music/links/{sign}

Return a sign-specific link to the separate music service. Does not open the service, send personal data, create music or make a purchase.

MCP: mazzarot_get_music_link

Input and example output
{
  "sign": "aries"
}
{
  "sign": "aries",
  "url": "https://laintely.com/music?source=mazzarot&campaign=zodiac-companion&sign=aries#crear",
  "externalService": true,
  "purchaseIncluded": false
}

Connect through MCP

Transport: Streamable HTTP. Endpoint: /mcp. No authentication for these public read-only tools. Use an MCP client that supports direct remote HTTP connections.

{
  "mcpServers": {
    "mazzarot": {
      "url": "https://YOUR_DEPLOYED_HOST/mcp"
    }
  }
}

Client configuration syntax varies; replace the example host. No client settings are changed automatically.

The official SDK handles initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list and prompts/get. Tools declare input/output schemas and read-only, non-destructive, idempotent, closed-world annotations.

curl "$BASE_URL/mcp" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example-client","version":"1.0"}}}'

Resources: mazzarot://capabilities, mazzarot://plans, mazzarot://import-policy. Prompt: companion_reflection with a valid sign. This prompt is a template, not a model call.

No persistent MCP sessions, server-initiated SSE, sampling, shell access, file upload, payments or private write tools. GET and DELETE on /mcp return 405. A notification returns 202.

Security and limits

Common errors: 400 invalid input; 403 origin/host denied; 404 route not found; 405 wrong method; 413 oversized body; 415 wrong content type; 503 private capability unavailable. Do not repeatedly retry 4xx or disabled-capability 503 responses.

20 unavailable private contracts

These routes always return 503 CAPABILITY_UNAVAILABLE, including requests carrying bearer tokens. They are not MCP tools. Scope names below are future requirements, not active OAuth grants. No private input is parsed or saved.

RouteFuture scopePurpose
GET /v1/meprofile:readAuthenticated account identity; never browser-local profile.
GET /v1/conversationsconversations:readTenant-bound conversation history with cursor pagination.
POST /v1/conversationsconversations:writeCreate an account-owned conversation; idempotency required.
POST /v1/chat/messageschat:writeLive assistant response; consent, entitlement and cost reservation required.
GET /v1/memorymemory:readCanonical approved memory only; cursor pagination.
POST /v1/memory/importsmemory:writeExplicit-consent import staging, provenance and review; never automatic approval.
GET /v1/taskstasks:readAccount-owned task list; not browser-local tasks.
POST /v1/taskstasks:writeCreate a tenant-bound task; idempotency required.
GET /v1/power/balancepower:readReal weekly/reserve balances from the canonical ledger.
GET /v1/power/ledgerpower:readAccount-scoped usage receipts, cursor-paginated.
POST /v1/builder/operations/list_projectsbuilder:readReserved list_projects contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/list_filesbuilder:readReserved list_files contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/read_sourcebuilder:readReserved read_source contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/scan_projectbuilder:writeReserved scan_project contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/generate_patchbuilder:writeReserved generate_patch contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/preview_diffbuilder:readReserved preview_diff contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/save_safe_branchbuilder:writeReserved save_safe_branch contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/get_build_statusbuilder:readReserved get_build_status contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/get_previewbuilder:readReserved get_preview contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.
POST /v1/builder/operations/get_audit_historybuilder:readReserved get_audit_history contract. Requires canonical user/tenant assignment, audit and applicable Power/review gates.

Activation requires canonical authentication, server-derived tenant/user identity, explicit project assignments, durable approval and audit, atomic Power reservation/settlement and verified execution adapters. Owner-level credentials are not customer authentication. No direct main writes, automatic merges or production deployments.