Servers Playground How we check Submit a server

Mistral MCP by usefulapi

Working · 561 ms

io.usefulapi/mistralv1.17.0 Domain verified

Manage your Mistral platform — models, files, batch jobs, agents and RAG document libraries.

AI & Agents

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://mistral.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

mistral_cancel_batch_job

Cancels a running Mistral batch job — stops processing and further billing for that job. Management API: POST /v1/batch/jobs/{job_id}/cancel.

job_idstring, required

The batch job id (UUID) to cancel.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Mistral MCP by usefulapi MCP server | mcptry

Tools (15)

mistral_cancel_batch_job

Cancels a running Mistral batch job — stops processing and further billing for that job. Management API: POST /v1/batch/jobs/{job_id}/cancel.

destructive

Argument	Type	Description
job_id*	string	The batch job id (UUID) to cancel.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The batch job id (UUID) to cancel."
    }
  }
}

mistral_create_agent

Creates a Mistral Agent (additive configuration). Management API: POST /v1/agents. Requires model and name; instructions, tools, completion_args, description and handoffs are optional.

destructive

Argument	Type	Description
name*	string	Human-readable agent name.
model*	string	Model powering the agent, e.g. mistral-large-latest.
tools	array	Tools available to the agent (passthrough objects, e.g. {type:'web_search'}).
handoffs	array	Agent ids this agent may hand off to.
description	string	Free-text description of the agent.
instructions	string	System instruction prompt the agent follows.
completion_args	object	Completion arguments (temperature, top_p, etc.) as a passthrough object.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "model",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Human-readable agent name."
    },
    "model": {
      "type": "string",
      "description": "Model powering the agent, e.g. mistral-large-latest."
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      },
      "description": "Tools available to the agent (passthrough objects, e.g. {type:'web_search'})."
    },
    "handoffs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Agent ids this agent may hand off to."
    },
    "description": {
      "type": "string",
      "description": "Free-text description of the agent."
    },
    "instructions": {
      "type": "string",
      "description": "System instruction prompt the agent follows."
    },
    "completion_args": {
      "type": "object",
      "description": "Completion arguments (temperature, top_p, etc.) as a passthrough object.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

mistral_delete_file

Permanently deletes an uploaded file from Mistral. Destructive. Management API: DELETE /v1/files/{file_id}.

destructive

Argument	Type	Description
file_id*	string	The file id (UUID) to delete.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "file_id"
  ],
  "properties": {
    "file_id": {
      "type": "string",
      "description": "The file id (UUID) to delete."
    }
  }
}

mistral_get_agent

Retrieve a single agent entity with its configuration. Management API: GET /v1/agents/{agent_id}.

read-only

Argument	Type	Description
agent_id*	string	The agent id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "The agent id."
    }
  }
}

mistral_get_batch_job

Retrieve details and status for a single batch job. Management API: GET /v1/batch/jobs/{job_id}.

read-only

Argument	Type	Description
job_id*	string	The batch job id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The batch job id (UUID)."
    }
  }
}

mistral_get_file

Retrieve metadata about a specific uploaded file. Management API: GET /v1/files/{file_id}.

read-only

Argument	Type	Description
file_id*	string	The file id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "file_id"
  ],
  "properties": {
    "file_id": {
      "type": "string",
      "description": "The file id (UUID)."
    }
  }
}

mistral_get_file_url

Get a temporary signed download URL for an uploaded file. Management API: GET /v1/files/{file_id}/url.

read-only

Argument	Type	Description
file_id*	string	The file id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "file_id"
  ],
  "properties": {
    "file_id": {
      "type": "string",
      "description": "The file id (UUID)."
    }
  }
}

mistral_get_library

Retrieve details about a single document library. Management API: GET /v1/libraries/{library_id}.

read-only

Argument	Type	Description
library_id*	string	The library id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "library_id"
  ],
  "properties": {
    "library_id": {
      "type": "string",
      "description": "The library id (UUID)."
    }
  }
}

mistral_get_model

Retrieve details for a single model (base or fine-tuned). Management API: GET /v1/models/{model_id}.

read-only

Argument	Type	Description
model_id*	string	The model id, e.g. mistral-large-latest or a fine-tuned model id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "model_id"
  ],
  "properties": {
    "model_id": {
      "type": "string",
      "description": "The model id, e.g. mistral-large-latest or a fine-tuned model id."
    }
  }
}

mistral_list_agents

List agent entities in your account, sorted by creation time. Management API: GET /v1/agents.

read-only

Argument	Type	Description
page	integer	Page number (0-indexed). Default 0.
page_size	integer	Agents per page. Default 20.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page number (0-indexed). Default 0."
    },
    "page_size": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Agents per page. Default 20.",
      "exclusiveMinimum": 0
    }
  }
}

mistral_list_batch_jobs

List batch inference jobs for your organization and user, with optional filters. Management API: GET /v1/batch/jobs.

read-only

Argument	Type	Description
page	integer	Page number (0-indexed). Default 0.
model	string	Filter by model name.
status	string	Filter by job status, e.g. QUEUED, RUNNING, SUCCESS, FAILED, CANCELLED.
page_size	integer	Jobs per page. Default 100.
created_after	string	ISO 8601 date-time; only jobs created after this time.
created_by_me	boolean	If true, only jobs created by the current user. Default false.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page number (0-indexed). Default 0."
    },
    "model": {
      "type": "string",
      "description": "Filter by model name."
    },
    "status": {
      "type": "string",
      "description": "Filter by job status, e.g. QUEUED, RUNNING, SUCCESS, FAILED, CANCELLED."
    },
    "page_size": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Jobs per page. Default 100.",
      "exclusiveMinimum": 0
    },
    "created_after": {
      "type": "string",
      "description": "ISO 8601 date-time; only jobs created after this time."
    },
    "created_by_me": {
      "type": "boolean",
      "description": "If true, only jobs created by the current user. Default false."
    }
  }
}

mistral_list_files

List uploaded files belonging to your organization (fine-tune data, batch inputs/outputs, etc.). Management API: GET /v1/files.

read-only

Argument	Type	Description
page	integer	Page number (0-indexed). Default 0.
search	string	Search files by name.
source	string	Filter by source, e.g. upload, mistral.
purpose	string	Filter by purpose, e.g. fine-tune, batch.
page_size	integer	Files per page. Default 100.
sample_type	string	Filter by sample type, e.g. instruct, batch_request.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page number (0-indexed). Default 0."
    },
    "search": {
      "type": "string",
      "description": "Search files by name."
    },
    "source": {
      "type": "string",
      "description": "Filter by source, e.g. upload, mistral."
    },
    "purpose": {
      "type": "string",
      "description": "Filter by purpose, e.g. fine-tune, batch."
    },
    "page_size": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Files per page. Default 100.",
      "exclusiveMinimum": 0
    },
    "sample_type": {
      "type": "string",
      "description": "Filter by sample type, e.g. instruct, batch_request."
    }
  }
}

mistral_list_libraries

List RAG document libraries you own or that have been shared with you. Management API: GET /v1/libraries.

read-only

Argument	Type	Description
page	integer	Deprecated offset page (use page_token). Default 0.
search	string	Case-insensitive search on the library name.
page_size	integer	Libraries per page (1-100). Default 100.
page_token	string	Continuation cursor from a previous response's next_page_token.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Deprecated offset page (use page_token). Default 0."
    },
    "search": {
      "type": "string",
      "description": "Case-insensitive search on the library name."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Libraries per page (1-100). Default 100."
    },
    "page_token": {
      "type": "string",
      "description": "Continuation cursor from a previous response's next_page_token."
    }
  }
}

mistral_list_library_documents

List the documents uploaded to a given document library. Management API: GET /v1/libraries/{library_id}/documents.

read-only

Argument	Type	Description
page	integer	Page number (0-indexed). Default 0.
search	string	Search documents by name.
page_size	integer	Documents per page (1-100). Default 100.
library_id*	string	The library id (UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "library_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Page number (0-indexed). Default 0."
    },
    "search": {
      "type": "string",
      "description": "Search documents by name."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Documents per page (1-100). Default 100."
    },
    "library_id": {
      "type": "string",
      "description": "The library id (UUID)."
    }
  }
}

mistral_list_models

List every model available to your account — Mistral base models plus your fine-tuned models. Management API: GET /v1/models.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}