MiniMax MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with MiniMax MCP or direct API to generate text, create images and videos, synthesize speech, and process files through natural language.

MiniMax logoMiniMax
Api Key

MiniMax is a multimodal AI platform for text, video, speech, image, music, and file workflows. Its unified APIs help developers build rich AI experiences from one service.

35 Tools

Try MiniMax now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
MiniMax
Try asking
TOOLS

Supported Tools

Every MiniMax action and event your agent gets out of the box.

Clone Voice

Create a reusable MiniMax cloned voice from an uploaded voice sample, optionally generating paid preview audio.

Count Message Tokens

Count input tokens for an Anthropic-compatible message payload without generating content.

Create Async Speech

Start a long-form asynchronous MiniMax speech synthesis task from inline text or one uploaded text file.

Create Legacy Video

Start a MiniMax v1 Hailuo text, image, first-and-last-frame, or subject-reference video task with mode-specific validation.

Create OpenAI-Compatible Response

Call MiniMax through its OpenAI Responses compatibility contract and return one non-streaming response object.

Create Template Video

Start a MiniMax Video Agent task using an official template and its ordered text and media inputs.

Create Video

Start a MiniMax H3 video v2 generation task from text and optional reference media.

Create Video Prompt

Start a MiniMax H3 Context-IR task that converts multimodal context into an enhanced video prompt.

Delete File

Permanently delete one MiniMax file by its exact ID and storage-purpose category.

Cancel or Delete Video Task

Cancel a queued MiniMax video v2 task, or permanently delete a completed or failed task record.

Delete Voice

Permanently delete an eligible MiniMax cloned or designed voice.

Design Voice

Design a reusable MiniMax voice from a description and return its paid preview as a downloadable audio file.

Download File

Download the binary contents of one generated MiniMax file and return a managed file reference.

Estimate Responses Input Tokens

Estimate input tokens using MiniMax's OpenAI Responses compatibility contract without generating model output.

Generate Anthropic-Compatible Message

Call MiniMax through its Anthropic Messages compatibility contract and return one non-streaming message response.

Generate Image

Generate one or more images from a text prompt, optionally guided by a subject reference.

Generate Native Chat Completion

Call MiniMax's native chatcompletion_v2 contract and return one non-streaming completion, including native sensitivity metadata.

Generate Text

Generate one non-streaming OpenAI-compatible chat completion, including optional reasoning and tool calls.

Get Account Balance

Get the connected global pay-as-you-go MiniMax account's available, cash, voucher, credit, owed, and balance-alert amounts.

Get Anthropic-Compatible Model

Retrieve one MiniMax text model through the Anthropic Models compatibility contract.

Get Async Speech Task

Get the status and generated file reference for a MiniMax asynchronous speech synthesis task.

Get File

Retrieve metadata for one MiniMax file by its exact ID, including a temporary download URL when MiniMax provides one for a generated output.

Get Legacy Video Task

Get the status and output file metadata of a MiniMax v1 legacy video task.

Get Template Video Task

Get the status and temporary result URL of a MiniMax Video Agent template task.

Get OpenAI-Compatible Text Model

Retrieve one MiniMax text model through the OpenAI Models compatibility contract.

Get Video Task

Get the current state and output of one MiniMax video v2 task created within the last seven days.

List Anthropic-Compatible Models

List one page of MiniMax text models through the Anthropic Models compatibility contract, using its after_id or before_id cursors.

List Files

List MiniMax files for one upload-purpose category.

List Text Models

List text model IDs currently available to the connected MiniMax API key.

List Video Tasks

List one page of MiniMax video v2 tasks from the last seven days, optionally filtered by status, task ID, model, or task type.

List Voices

List system, cloned, generated, or all voices that can be used for speech synthesis.

Regenerate Video

Regenerate an eligible MiniMax-H3 768P source video as a 2K video, using either its task ID or the exact original inputs and source video.

Synthesize Speech

Synchronously synthesize up to 9,999 characters of text and return the decoded audio as a downloadable file.

Transcribe Audio

Transcribe an uploaded audio file with optional language hints, timestamps, speaker diarization, subtitle output, or assembled streaming output.

Upload File

Upload one file to MiniMax as multipart/form-data for voice cloning, async speech, video understanding, or video generation.

SETUP GUIDE

Connect MiniMax MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["minimax"],
  mcp: true,
});
Create a session scoped to MiniMax and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Generate a 10-second product video for a blue wireless speaker with upbeat background music.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a MiniMax request
SETUP GUIDE

Connect MiniMax API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["minimax"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to MiniMax
3

Run MiniMax tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Generate a 10-second product video for a blue wireless speaker with upbeat background music." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the MiniMax tool calls through the session, and print the final answer

Why Use Composio?

AI Native MiniMax Integration

  • Supports both MiniMax MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable text, image, video, speech, and file tool execution
  • Rich coverage for creating and processing multimodal content with MiniMax

Managed Auth

  • Secure API key handling without exposing credentials in agent prompts or application code
  • Central place to manage, scope, and revoke MiniMax access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear schemas help agents choose the right MiniMax tool for text, image, video, speech, music, and file tasks
  • Comprehensive execution logs show what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access MiniMax
  • Scoped, least privilege access to MiniMax resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Yes, MiniMax requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your MiniMax connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Create the key in your MiniMax account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the MiniMax actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside MiniMax at any time.

When you connect a MiniMax account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in MiniMax as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside MiniMax. If MiniMax lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside MiniMax at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each MiniMax connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment MiniMax rejects the old key. Create a new key in MiniMax and reconnect the account from the Composio dashboard or by asking your agent to reconnect MiniMax. Nothing else changes.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal MiniMax use. Paid plans add higher limits and team features. Your MiniMax plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple MiniMax accounts).

With Composio, you connect MiniMax once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with MiniMax.It takes 30 seconds.

Managed auth, hosted MCP servers, and every MiniMax tool your agent needs.Free to start.

Start building