Mint/mcp

mint:read

Wait For Status

wait_for_status

Briefly waits for a generation to reach a stage, then returns current status, safe moderation categories when available, and retry guidance. timeout_ms is capped at 60000.

Parameters

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

  • asset_typerequired

    "world" | "model" | "asset_pack" | "material" | "material_pack" | "image" | "audio"

  • asset_idrequired

    string

  • timeout_ms

    number

  • poll_interval_ms

    number

  • until_stage

    "preview" | "final"

  • 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",
  "until_stage": "preview",
  "timeout_ms": 30000,
  "poll_interval_ms": 5000
}

Example response

{
  "assetType": "model",
  "assetId": "mn785pg330fdx30ty4achjv80985ne5z",
  "type": "model",
  "name": "Blush Cloud Loveseat",
  "status": "preview_ready",
  "assetStage": "preview",
  "previewImageUrl": "https://cdn.mint.gg/images/models/blush-cloud-loveseat-preview.webp",
  "chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
  "presentationHint": "Show chatUrl to the user as the Open in Mint link. You may render previewImageUrl inline when useful, but do not show raw CDN, thumbnail, pano, mesh, audio file, asset id, or provider URLs as text.",
  "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",
        "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"
      }
    },
    {
      "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"
      }
    },
    {
      "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",
        "artifact_id": "<artifact_id>"
      }
    }
  ],
  "retryAfterMs": null,
  "retryGuidance": null,
  "failureClass": null,
  "failureCode": null,
  "failureReason": null,
  "moderationCategories": [],
  "retryable": false,
  "terminal": true,
  "reason": "stage_reached",
  "workflowStage": "preview_ready",
  "workflowStageUpdatedAt": 1745625420000,
  "lastHeartbeatAt": 1745625418000
}

Use cases

  • Wait briefly for a preview before reviewing or approving it.
  • Explain a moderation failure using normalized policy labels instead of internal errors.
  • Return chatUrl and retry guidance when final generation is still running.