{
  "$schema": "https://musa-v2.renzo-08c.workers.dev/.well-known/mcp.schema.json",
  "name": "Futuraria Design",
  "description": "AI-native platform for design, copywriting, contacts and configuration through MCP.",
  "production_url": "https://musa-v2.renzo-08c.workers.dev",
  "mcp": {
    "endpoint": "https://musa-v2.renzo-08c.workers.dev/mcp",
    "protocol": "JSON-RPC 2.0 over HTTP POST (SSE for streaming)",
    "protocol_version": "2024-11-05",
    "transport": "http"
  },
  "auth": {
    "type": "api_key",
    "header_name": "x-api-key",
    "required_for": "initialize, tools/list and tools/call (everything except verify_api_key)",
    "not_required_for": [
      "verify_api_key"
    ],
    "key_format": "fdr_ws_<random>",
    "key_expiry": "never (keys are permanent — create once, use forever)",
    "how_to_get_key": {
      "step_1": "The HUMAN user logs into https://musa-v2.renzo-08c.workers.dev",
      "step_2": "Opens Configuración › Conecta tu IA",
      "step_3": "Creates a key (format: fdr_ws_...) and copies it right away — it is shown only once",
      "step_4": "Pastes it into the MCP client config as a header: x-api-key: fdr_ws_... (or Authorization: Bearer fdr_ws_...)"
    },
    "key_diagnostic": "If auth fails, call verify_api_key({ apiKey: 'YOUR_KEY' }) — it's a public tool (no auth needed) that tells you exactly why (not_found, revoked, expired, database_error).",
    "oauth": {
      "available": true,
      "standard": "OAuth 2.1 per the MCP Authorization spec (2025-06-18): RFC9728 protected-resource metadata + RFC8414 authorization-server metadata + RFC7591 dynamic client registration + PKCE S256",
      "protected_resource_metadata": "https://musa-v2.renzo-08c.workers.dev/.well-known/oauth-protected-resource",
      "authorization_servers": [
        "https://musa-v2.renzo-08c.workers.dev"
      ],
      "authorization_endpoint": "https://musa-v2.renzo-08c.workers.dev/oauth/authorize",
      "token_endpoint": "https://musa-v2.renzo-08c.workers.dev/oauth/token",
      "registration_endpoint": "https://musa-v2.renzo-08c.workers.dev/oauth/register",
      "scopes": [
        "design.read",
        "design.write"
      ],
      "note_for_clients": "OAuth issues USER tokens (Supabase sessions) scoped to the logged-in user's workspaces — for clients like ChatGPT or Claude web that cannot send custom headers. The x-api-key header (or ?key= in the URL, REQ-011) remains fully supported; use whichever your client allows."
    },
    "config_examples": {
      "cursor": {
        "file": ".cursor/mcp.json",
        "config": {
          "mcpServers": {
            "futuraria": {
              "url": "https://musa-v2.renzo-08c.workers.dev/mcp",
              "headers": {
                "x-api-key": "fdr_ws_YOUR_KEY_HERE"
              }
            }
          }
        }
      },
      "claude_desktop": {
        "file": "claude_desktop_config.json",
        "config": {
          "mcpServers": {
            "futuraria": {
              "url": "https://musa-v2.renzo-08c.workers.dev/mcp",
              "headers": {
                "x-api-key": "fdr_ws_YOUR_KEY_HERE"
              }
            }
          }
        }
      },
      "custom_client": {
        "method": "POST",
        "url": "https://musa-v2.renzo-08c.workers.dev/mcp",
        "headers": {
          "Content-Type": "application/json",
          "x-api-key": "fdr_ws_YOUR_KEY_HERE"
        },
        "body_example": "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{}}"
      }
    },
    "also_accepted": "Authorization: Bearer <key> or ?key=<key> in the URL"
  },
  "agent_onboarding": {
    "what_am_i": "Futuraria lets AI agents create and manage designs, content, contacts and configuration through MCP. Read MUSA_START.md first; load only the tools needed for the request.",
    "what_can_i_do": [
      "Create design templates with HTML+CSS (import_design, create_template)",
      "Create frames at specific dimensions (1080x1080, 1080x1920, 1080x1350, etc.)",
      "Edit HTML and CSS of existing designs (set_html, set_css, set_frame_layers)",
      "Export designs as PNG/JPG (render_frame, export_batch)",
      "Extract design systems and brand guidelines (get_design_system)",
      "Generate 100+ design variants from CSV data (render_batch)",
      "Create and edit standalone video projects with CapCut semantics — µs timeline, tracks, clips, effects, templates (video_project_create, video_track_add, video_segment_add, video_effect_apply)",
      "Upload and manage brand assets (logos, images)",
      "Manage workspaces, brands, and templates"
    ],
    "step_by_step": [
      "1. POST to https://musa-v2.renzo-08c.workers.dev/mcp with method 'initialize' — no auth needed. Read the _agentGuide in the response.",
      "2. Read https://musa-v2.renzo-08c.workers.dev/MUSA_START.md for the short route by module.",
      "3. Call get_agent_guide (no auth) only if you need an onboarding summary; use tools/list to discover specific tool schemas.",
      "4. Ask the HUMAN user for their API key (they create it at Settings -> API MCP).",
      "5. Once you have the key, include 'x-api-key: fdr_ws_...' header on all subsequent requests.",
      "6. Call list_workspaces to find where to create designs.",
      "7. Match the user's intent to a playbook: replicate-html, create-from-scratch, csv-batch, design-system, multi-agent, content-calendar.",
      "8. Use import_design({ templateId, document: '<full HTML with inline <style>>' }) to import designs — it's the primary tool for pasting HTML+CSS."
    ],
    "first_time_user_message": "Explain that you can help with design, content, contacts and configuration. Guide the user to create an account and configure OAuth or an MCP API key in their client. Verify the connection before reporting success. Read /MUSA_START.md first and use /SKILL.md only when detailed reference is needed."
  },
  "documentation": {
    "quickstart": "https://musa-v2.renzo-08c.workers.dev/MUSA_START.md",
    "skill_md": "https://musa-v2.renzo-08c.workers.dev/SKILL.md",
    "docs_base": "https://musa-v2.renzo-08c.workers.dev/docs/",
    "tool_catalog": "https://musa-v2.renzo-08c.workers.dev/docs/MCP_TOOL_CATALOG.md",
    "downloads": {
      "skill_md_download": "https://musa-v2.renzo-08c.workers.dev/SKILL.md (downloadable — full instructions for humans and AIs, complete tool catalog included)",
      "mcp_json_download": "https://musa-v2.renzo-08c.workers.dev/.well-known/mcp.json (downloadable — machine-readable discovery)"
    },
    "playbooks": {
      "replicate-html": "Copy HTML+CSS into a frame, adapt to formats",
      "create-from-scratch": "Build a new design from a description",
      "csv-batch": "Generate 100+ variants from a CSV data source",
      "design-system": "Extract design tokens and generate brand identity guide",
      "multi-agent": "Multiple AI agents edit the same template simultaneously",
      "content-calendar": "Propose calendar ideas, human approves, design batch, attach template ids"
    }
  }
}
