Mint/mcp

mint:generate:start

Start Audio Generation

start_audio_generation

Starts final-only playable audio generation for sound effects, UI sounds, ambience, or music.

Parameters

Input schema generated from the registry. Required parameters are tagged.

  • promptrequired

    string

  • audio_kindrequired

    "sound_effect" | "general_audio"

  • duration_seconds

    number

  • display_name_hint

    string

  • chat_id

    string

  • contextrequired

    string

    Describe the user's goal and why this tool helps in 15-25 words. Do not include credentials, personal data, identifiers, URLs, emails, or account addresses.

Example request

{
  "prompt": "A crisp coin pickup sound for a cozy mobile game UI.",
  "audio_kind": "sound_effect",
  "duration_seconds": 2,
  "display_name_hint": "Coin Pickup"
}

Example response

{
  "status": "queued",
  "assetType": "audio",
  "assetId": "audcoinpickup123",
  "chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatCreated": true,
  "pollIntervalMs": 30000,
  "summary": "Audio generation started.",
  "lifecycleStatus": "running",
  "audioKind": "sound_effect",
  "durationSeconds": 2,
  "approvalRequiredForFinalGeneration": false,
  "nextSteps": [
    {
      "tool": "wait_for_status",
      "action": "wait_for_final",
      "description": "Poll until Mint reports final output eligibility before trying to use files in a code project.",
      "input": {
        "asset_type": "audio",
        "asset_id": "audcoinpickup123",
        "until_stage": "final"
      }
    },
    {
      "tool": "list_asset_artifacts",
      "action": "list_downloadable_artifacts",
      "description": "After the asset reaches final, list downloadable artifacts and choose a downloadable artifact_id.",
      "input": {
        "asset_type": "audio",
        "asset_id": "audcoinpickup123"
      }
    },
    {
      "tool": "get_asset_artifact_manifest",
      "action": "fetch_artifact_manifest",
      "description": "Fetch a ready-to-copy artifact manifest with durable downloadUrls, suggested project paths, and loader hints for code-project imports.",
      "input": {
        "asset_type": "audio",
        "asset_id": "audcoinpickup123"
      }
    },
    {
      "tool": "get_asset_artifact",
      "action": "fetch_artifact_download_url",
      "description": "Fetch the chosen artifact to receive mintUrl plus downloadUrl for curl, R3F loaders, browser audio, or game runtime code.",
      "input": {
        "asset_type": "audio",
        "asset_id": "audcoinpickup123",
        "artifact_id": "<artifact_id>"
      }
    }
  ]
}

Use cases

  • Generate a sound effect, UI sound, short ambience, or music loop from text.
  • Wait for final readiness, then fetch the generated audio file through artifact tools.