Mint/mcp

mint:generate:start

Start Material Generation

start_material_generation

Starts standalone PBR material generation or material map extraction.

Parameters

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

  • prompt

    string

  • mode

    "generate" | "image_to_maps" | "extract"

  • display_name_hint

    string

  • chat_id

    string

  • image_url

    string (URL)

  • source_url

    string (URL)

  • 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": "Mossy stone wall blocks with damp crevices and subtle lichen.",
  "mode": "generate",
  "display_name_hint": "Mossy Stone"
}

Example response

{
  "status": "queued",
  "assetType": "material",
  "assetId": "matmossystone123",
  "chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatCreated": true,
  "pollIntervalMs": 30000,
  "summary": "Material run queued.",
  "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": "material",
        "asset_id": "matmossystone123",
        "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": "material",
        "asset_id": "matmossystone123"
      }
    },
    {
      "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": "material",
        "asset_id": "matmossystone123"
      }
    },
    {
      "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": "material",
        "asset_id": "matmossystone123",
        "artifact_id": "<artifact_id>"
      }
    }
  ]
}

Use cases

  • Create a standalone seamless material or PBR map set.
  • Convert a source texture image into material maps.

Related Mint workflow

AI PBR Material generation