Mistral MCP by usefulapi is an MCP server published by io.usefulapi, hosted at mistral.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 15 tools, including mistral_list_models, mistral_get_model, mistral_list_files, mistral_get_file, mistral_get_file_url.
Manage your Mistral platform — models, files, batch jobs, agents and RAG document libraries.
4,323 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
List every model available to your account — Mistral base models plus your fine-tuned models. Management API: GET /v1/models.
No parameters.
{
"name": "mistral_list_models",
"title": "List models",
"description": "List every model available to your account — Mistral base models plus your fine-tuned models. Management API: GET /v1/models.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List models",
"readOnlyHint": true
}
}Retrieve details for a single model (base or fine-tuned). Management API: GET /v1/models/{model_id}.
| Parameter | Type | Description |
|---|---|---|
| model_id * | string | The model id, e.g. mistral-large-latest or a fine-tuned model id. |
{
"name": "mistral_get_model",
"title": "Get a model",
"description": "Retrieve details for a single model (base or fine-tuned). Management API: GET /v1/models/{model_id}.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Get a model",
"readOnlyHint": true
}
}List uploaded files belonging to your organization (fine-tune data, batch inputs/outputs, etc.). Management API: GET /v1/files.
| Parameter | 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. |
{
"name": "mistral_list_files",
"title": "List files",
"description": "List uploaded files belonging to your organization (fine-tune data, batch inputs/outputs, etc.). Management API: GET /v1/files.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List files",
"readOnlyHint": true
}
}Retrieve metadata about a specific uploaded file. Management API: GET /v1/files/{file_id}.
| Parameter | Type | Description |
|---|---|---|
| file_id * | string | The file id (UUID). |
{
"name": "mistral_get_file",
"title": "Get a file",
"description": "Retrieve metadata about a specific uploaded file. Management API: GET /v1/files/{file_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "The file id (UUID)."
}
}
},
"annotations": {
"title": "Get a file",
"readOnlyHint": true
}
}Get a temporary signed download URL for an uploaded file. Management API: GET /v1/files/{file_id}/url.
| Parameter | Type | Description |
|---|---|---|
| file_id * | string | The file id (UUID). |
{
"name": "mistral_get_file_url",
"title": "Get a file download URL",
"description": "Get a temporary signed download URL for an uploaded file. Management API: GET /v1/files/{file_id}/url.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "The file id (UUID)."
}
}
},
"annotations": {
"title": "Get a file download URL",
"readOnlyHint": true
}
}List batch inference jobs for your organization and user, with optional filters. Management API: GET /v1/batch/jobs.
| Parameter | 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. |
{
"name": "mistral_list_batch_jobs",
"title": "List batch jobs",
"description": "List batch inference jobs for your organization and user, with optional filters. Management API: GET /v1/batch/jobs.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List batch jobs",
"readOnlyHint": true
}
}Retrieve details and status for a single batch job. Management API: GET /v1/batch/jobs/{job_id}.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | The batch job id (UUID). |
{
"name": "mistral_get_batch_job",
"title": "Get a batch job",
"description": "Retrieve details and status for a single batch job. Management API: GET /v1/batch/jobs/{job_id}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get a batch job",
"readOnlyHint": true
}
}List agent entities in your account, sorted by creation time. Management API: GET /v1/agents.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed). Default 0. |
| page_size | integer | Agents per page. Default 20. |
{
"name": "mistral_list_agents",
"title": "List agents",
"description": "List agent entities in your account, sorted by creation time. Management API: GET /v1/agents.",
"inputSchema": {
"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
}
}
},
"annotations": {
"title": "List agents",
"readOnlyHint": true
}
}Retrieve a single agent entity with its configuration. Management API: GET /v1/agents/{agent_id}.
| Parameter | Type | Description |
|---|---|---|
| agent_id * | string | The agent id. |
{
"name": "mistral_get_agent",
"title": "Get an agent",
"description": "Retrieve a single agent entity with its configuration. Management API: GET /v1/agents/{agent_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"agent_id"
],
"properties": {
"agent_id": {
"type": "string",
"description": "The agent id."
}
}
},
"annotations": {
"title": "Get an agent",
"readOnlyHint": true
}
}List RAG document libraries you own or that have been shared with you. Management API: GET /v1/libraries.
| Parameter | 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. |
{
"name": "mistral_list_libraries",
"title": "List document libraries",
"description": "List RAG document libraries you own or that have been shared with you. Management API: GET /v1/libraries.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List document libraries",
"readOnlyHint": true
}
}Retrieve details about a single document library. Management API: GET /v1/libraries/{library_id}.
| Parameter | Type | Description |
|---|---|---|
| library_id * | string | The library id (UUID). |
{
"name": "mistral_get_library",
"title": "Get a document library",
"description": "Retrieve details about a single document library. Management API: GET /v1/libraries/{library_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"library_id"
],
"properties": {
"library_id": {
"type": "string",
"description": "The library id (UUID)."
}
}
},
"annotations": {
"title": "Get a document library",
"readOnlyHint": true
}
}List the documents uploaded to a given document library. Management API: GET /v1/libraries/{library_id}/documents.
| Parameter | 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). |
{
"name": "mistral_list_library_documents",
"title": "List documents in a library",
"description": "List the documents uploaded to a given document library. Management API: GET /v1/libraries/{library_id}/documents.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List documents in a library",
"readOnlyHint": true
}
}Creates a Mistral Agent (additive configuration). Management API: POST /v1/agents. Requires model and name; instructions, tools, completion_args, description and handoffs are optional.
| Parameter | 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. |
{
"name": "mistral_create_agent",
"title": "Create an agent",
"description": "Creates a Mistral Agent (additive configuration). Management API: POST /v1/agents. Requires model and name; instructions, tools, completion_args, description and handoffs are optional.",
"inputSchema": {
"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": {}
}
}
},
"annotations": {
"title": "Create an agent",
"destructiveHint": true
}
}Cancels a running Mistral batch job — stops processing and further billing for that job. Management API: POST /v1/batch/jobs/{job_id}/cancel.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | The batch job id (UUID) to cancel. |
{
"name": "mistral_cancel_batch_job",
"title": "Cancel a batch job",
"description": "Cancels a running Mistral batch job — stops processing and further billing for that job. Management API: POST /v1/batch/jobs/{job_id}/cancel.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Cancel a batch job",
"destructiveHint": true
}
}Permanently deletes an uploaded file from Mistral. Destructive. Management API: DELETE /v1/files/{file_id}.
| Parameter | Type | Description |
|---|---|---|
| file_id * | string | The file id (UUID) to delete. |
{
"name": "mistral_delete_file",
"title": "Delete a file",
"description": "Permanently deletes an uploaded file from Mistral. Destructive. Management API: DELETE /v1/files/{file_id}.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Delete a file",
"destructiveHint": true
}
}Tools for Mistral, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which models are available on my account?"; "Which batch jobs are running or finished recently?"; "What files have I uploaded to my account?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Mistral data. Free plan: 50 tool calls per month. Run mistral_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run mistral_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run mistral_upgrade without a plan: it returns both plans, each with a payment link for the user to open. mistral_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.