Mint/mcp

mint:generate:start

Retry Failed Generation

retry_generation

Retries a failed 3D model or world in its existing Mint chat and returns a new successor asset handle.

Parameters

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

  • asset_typerequired

    "world" | "model"

  • asset_idrequired

    string

  • prompt

    string

    Optional replacement prompt. Required when the previous prompt was blocked by moderation.

  • mode

    "auto" | "review"

    auto is the default and proceeds through final generation; review pauses at preview-ready when the user explicitly wants to inspect or revise the retry.

  • 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

{
  "asset_type": "model",
  "asset_id": "mn785pg330fdx30ty4achjv80985ne5z"
}

Example response

{
  "status": "queued",
  "assetType": "model",
  "assetId": "mn785pg330fdx30ty4achjv80985ne5z_retry",
  "retryOfAssetId": "mn785pg330fdx30ty4achjv80985ne5z",
  "chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatCreated": false,
  "pollIntervalMs": 30000,
  "lifecycleStatus": "queued",
  "summary": "Model preview started again in the existing Mint chat.",
  "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": "model",
        "asset_id": "mn785pg330fdx30ty4achjv80985ne5z_retry",
        "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": "model",
        "asset_id": "mn785pg330fdx30ty4achjv80985ne5z_retry"
      }
    },
    {
      "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": "model",
        "asset_id": "mn785pg330fdx30ty4achjv80985ne5z_retry"
      }
    },
    {
      "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": "model",
        "asset_id": "mn785pg330fdx30ty4achjv80985ne5z_retry",
        "artifact_id": "<artifact_id>"
      }
    }
  ]
}

Use cases

  • Retry a temporary generation failure without creating another Mint chat.
  • Supply a changed prompt when the failed generation was blocked by moderation.

Related Mint workflow

AI 3D Model generation →
Previous← start_model_generationNextstart_asset_pack_generation →