{
  "info": {
    "name": "AI/ML API — mcp.ai",
    "description": "REST API for the AI/ML API MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/ai_ml_api",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "ai_ml_api_cancel_run",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/cancel/run",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "cancel",
            "run"
          ]
        },
        "description": "Tool to cancel a run that is currently in progress. Use when you need to stop an assistant run before it completes.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"run_id\": \"\",\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_create_assistant",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/assistant",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "assistant"
          ]
        },
        "description": "Tool to create an AI assistant with configurable model, instructions, and tools. Use when you need to set up a new assistant that can maintain conversation context and use tools like code_interpreter ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"model\": \"\",\n  \"tools\": \"\",\n  \"top_p\": 0,\n  \"metadata\": {},\n  \"description\": \"\",\n  \"temperature\": 0,\n  \"instructions\": \"\",\n  \"tool_resources\": {},\n  \"response_format\": \"\",\n  \"reasoning_effort\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_create_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "message"
          ]
        },
        "description": "Tool to create a new message in a thread. Use when you need to add a user or assistant message to an existing conversation thread.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"role\": \"\",\n  \"content\": \"\",\n  \"metadata\": {},\n  \"thread_id\": \"\",\n  \"attachments\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_create_run",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/run",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "run"
          ]
        },
        "description": "Tool to create a run that executes an assistant on a thread. The assistant processes messages in the thread and generates responses based on its instructions and available tools.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"model\": \"\",\n  \"tools\": \"\",\n  \"top_p\": 0,\n  \"metadata\": {},\n  \"thread_id\": \"\",\n  \"temperature\": 0,\n  \"tool_choice\": \"\",\n  \"assistant_id\": \"\",\n  \"instructions\": \"\",\n  \"response_format\": \"\",\n  \"max_prompt_tokens\": 0,\n  \"additional_messages\": \"\",\n  \"parallel_tool_calls\": false,\n  \"truncation_strategy\": {},\n  \"max_completion_tokens\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_create_thread",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/thread",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "thread"
          ]
        },
        "description": "Tool to create a new thread for conversation with an assistant. Threads store messages and maintain context across interactions. Use when starting a new conversation or when you need a fresh context f",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"messages\": \"\",\n  \"metadata\": {},\n  \"tool_resources\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_delete_assistant",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/assistant",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "assistant"
          ]
        },
        "description": "Tool to delete an assistant by ID. Use when you need to remove an assistant that is no longer needed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"assistant_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_delete_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "message"
          ]
        },
        "description": "Tool to delete a specific message from a thread. Use when you need to remove an unwanted or erroneous message from a conversation thread.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"thread_id\": \"\",\n  \"message_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_delete_thread",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/thread",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "thread"
          ]
        },
        "description": "Tool to delete a thread by its ID. Use when you need to remove an existing thread from the system.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_assistant",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/assistant",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "assistant"
          ]
        },
        "description": "Tool to retrieve details of a specific assistant by ID. Use when you need to fetch configuration, model settings, instructions, or available tools for an existing assistant.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"assistant_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_billing_balance",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/billing/balance",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "billing",
            "balance"
          ]
        },
        "description": "Tool to retrieve the current billing balance for the account. Use when you need to check available credits, balance status, or auto-debit configuration.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_luma_generation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/luma/generation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "luma",
            "generation"
          ]
        },
        "description": "Tool to fetch Luma AI video generation results by generation IDs. Use after creating a generation to check its status and retrieve the generated video URL when completed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "message"
          ]
        },
        "description": "Tool to retrieve information about a specific message by its ID. Use when you need to fetch details of a particular message in a thread.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"thread_id\": \"\",\n  \"message_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_response",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/response",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "response"
          ]
        },
        "description": "Tool to retrieve a previously generated model response by its unique ID. Use when you need to access details of a specific response, including its output, status, and usage statistics.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"include\": \"\",\n  \"response_id\": \"\",\n  \"starting_after\": 0,\n  \"include_obfuscation\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_run",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/run",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "run"
          ]
        },
        "description": "Tool to retrieve a specific run by ID from a thread. Use when you need to check the status, results, or details of a previously created run.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"run_id\": \"\",\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_run_step",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/run/step",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "run",
            "step"
          ]
        },
        "description": "Tool to retrieve a specific run step by its ID within a thread and run. Use when you need detailed information about a particular step's execution status and results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"run_id\": \"\",\n  \"step_id\": \"\",\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_get_thread",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/thread",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "thread"
          ]
        },
        "description": "Tool to retrieve information about a specific thread by ID. Use when you need to fetch thread details, metadata, or available tool resources for an existing conversation thread.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_assistants",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/assistants",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "assistants"
          ]
        },
        "description": "Tool to list all assistants associated with the account. Use when you need to retrieve available assistants with pagination support.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"after\": \"\",\n  \"limit\": 0,\n  \"order\": \"\",\n  \"before\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_batches",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/batches",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "batches"
          ]
        },
        "description": "Tool to get the status or results of a batch processing job. Use when you need to check the progress or retrieve results of a previously submitted batch.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"batch_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_luma_generations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/luma/generations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "luma",
            "generations"
          ]
        },
        "description": "Tool to fetch user's Luma AI video generations. Use when you need to retrieve a list of all Luma AI video generation tasks for the authenticated user.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_messages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/messages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "messages"
          ]
        },
        "description": "Tool to retrieve a list of messages from a specific thread. Use when you need to fetch conversation history or message content from an AI assistant thread.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"after\": \"\",\n  \"limit\": 0,\n  \"order\": \"\",\n  \"before\": \"\",\n  \"run_id\": \"\",\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_models",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/models",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "models"
          ]
        },
        "description": "Tool to list all available AI models from the AI/ML API. Use when you need to retrieve the complete catalog of 400+ models including chat, image, video, voice, and other model types.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_models_with_details",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/models/with/details",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "models",
            "with",
            "details"
          ]
        },
        "description": "Tool to list all available AI/ML models with detailed information including pricing, features, and capabilities. Use when you need to discover available models or get comprehensive model metadata.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_run_steps",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/run/steps",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "run",
            "steps"
          ]
        },
        "description": "Tool to list the steps in a run. Use when you need to retrieve and examine the execution steps of a specific run within a thread.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"after\": \"\",\n  \"limit\": 0,\n  \"order\": \"\",\n  \"before\": \"\",\n  \"run_id\": \"\",\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_list_runs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/runs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "runs"
          ]
        },
        "description": "Tool to list all runs for a specific thread. Use when you need to retrieve runs with pagination support.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"after\": \"\",\n  \"limit\": 0,\n  \"order\": \"\",\n  \"before\": \"\",\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_submit_tool_outputs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/submit/tool/outputs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "submit",
            "tool",
            "outputs"
          ]
        },
        "description": "Tool to submit tool outputs for a run that requires action. Use when a run has status 'requires_action' and needs tool call results to continue execution.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"run_id\": \"\",\n  \"stream\": false,\n  \"thread_id\": \"\",\n  \"tool_outputs\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_text_chat_completion",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/text/chat/completion",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "text",
            "chat",
            "completion"
          ]
        },
        "description": "Tool to generate text completions or chat responses using a specified LLM model. Use after assembling the conversation history to produce the next response.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"n\": 0,\n  \"stop\": \"\",\n  \"user\": \"\",\n  \"model\": \"\",\n  \"top_p\": 0,\n  \"stream\": false,\n  \"messages\": \"\",\n  \"logit_bias\": {},\n  \"max_tokens\": 0,\n  \"temperature\": 0,\n  \"presence_penalty\": 0,\n  \"frequency_penalty\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_update_assistant",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/assistant",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "assistant"
          ]
        },
        "description": "Tool to modify an existing assistant's properties including name, instructions, model, and tools. Use when you need to update an assistant's configuration or behavior after it has been created.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"model\": \"\",\n  \"tools\": \"\",\n  \"top_p\": 0,\n  \"metadata\": {},\n  \"description\": \"\",\n  \"temperature\": 0,\n  \"assistant_id\": \"\",\n  \"instructions\": \"\",\n  \"tool_resources\": {},\n  \"response_format\": {},\n  \"reasoning_effort\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_update_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "message"
          ]
        },
        "description": "Tool to modify metadata for a specific message in a thread. Use when you need to update message metadata such as tags or custom fields.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"metadata\": {},\n  \"thread_id\": \"\",\n  \"message_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_update_run",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/run",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "run"
          ]
        },
        "description": "Tool to update a run's metadata with key-value pairs. Use when you need to attach or modify additional information for a specific run.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"run_id\": \"\",\n  \"metadata\": {},\n  \"thread_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "ai_ml_api_update_thread",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/thread",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "thread"
          ]
        },
        "description": "Tool to update thread metadata and tool resources in the AI/ML API. Use when you need to modify existing thread properties or attach resources.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"metadata\": {},\n  \"thread_id\": \"\",\n  \"tool_resources\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}