Suede AI MCP

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "tags": {
      "type": "string",
      "description": "Comma-separated keywords to tag the generated file."
    },
    "style": {
      "type": "string",
      "description": "Specific musical style or genre tag (e.g., 'Hip Hop', 'Ambient', 'Rock'). Helping the AI focus on a specific sound."
    },
    "lyrics": {
      "type": "string",
      "description": "Your custom lyrics. Required if custom_mode is true."
    },
    "prompt": {
      "type": "string",
      "description": "Describe the song you want to create. Include genre, mood, instruments, and any specific vibe. Example: 'Upbeat 80s synthwave with driving bass and neon atmosphere' or 'A melancholic acoustic guitar ballad about rain'."
    },
    "custom_mode": {
      "type": "boolean",
      "description": "Set to true to use your own lyrics provided in the 'lyrics' field."
    },
    "vocal_gender": {
      "enum": [
        "m",
        "f"
      ],
      "type": "string",
      "description": "Preferred gender for the vocalist ('m' for male, 'f' for female)."
    },
    "durationSeconds": {
      "type": "integer",
      "default": 120,
      "maximum": 120,
      "minimum": 5,
      "description": "Duration of the track in seconds. Defaults to a full-length song."
    },
    "make_instrumental": {
      "type": "boolean",
      "description": "If true, generates a track without vocals."
    }
  }
}

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "seed": {
      "type": "integer",
      "description": "Optional random seed for reproducible renders."
    },
    "model": {
      "type": "string",
      "description": "Optional model preset variant. Leave unset for the default."
    },
    "prompt": {
      "type": "string",
      "description": "Narrative or visual prompt to drive the music video concept."
    },
    "asyncMode": {
      "type": "boolean",
      "description": "Return immediately with a jobId while the render runs. Can only switch async on: false is the same as omitting it, so a paid call stays asynchronous; ?async=false is the only way to force a blocking call."
    },
    "resolution": {
      "enum": [
        "720p",
        "1024p"
      ],
      "type": "string",
      "description": "Target rendering resolution."
    },
    "aspectRatio": {
      "enum": [
        "16:9",
        "9:16",
        "1:1"
      ],
      "type": "string",
      "description": "Desired frame aspect ratio."
    },
    "durationSeconds": {
      "type": "integer",
      "description": "Clip length in seconds (default 8)."
    }
  }
}

{
  "type": "object",
  "required": [
    "prompt"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Image description — subject, style, composition."
    },
    "asyncMode": {
      "type": "boolean",
      "description": "Return immediately with a jobId while the render runs. Can only switch async on: false is the same as omitting it, so a paid call stays asynchronous; ?async=false is the only way to force a blocking call."
    },
    "aspectRatio": {
      "type": "string",
      "description": "Aspect ratio, e.g. '1:1', '16:9', '9:16'."
    }
  }
}

{
  "type": "object",
  "required": [
    "prompt",
    "skyfireToken"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Original song description."
    },
    "skyfireToken": {
      "type": "string",
      "description": "Skyfire PAY or KYA-PAY token scoped to the Suede Create Music seller service. Treat as a bearer secret."
    },
    "make_instrumental": {
      "type": "boolean",
      "description": "Generate without vocals."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "songId"
  ],
  "properties": {
    "songId": {
      "type": "string",
      "description": "songId returned by skyfire_create_music."
    }
  },
  "additionalProperties": false
}