Beta Connectors Endpoints

(beta) Connectors API to create, manage, and call tools on MCP connectors.

List all connectors.

GET /v1/connectors

List all your custom connectors with keyset pagination and filters.

200

Successful Response

items

*array<Connector>

pagination

*PaginationResponse

Playground

Test the endpoints live

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.list(page_size=100)

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.list(page_size=100)

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "items": [
    {
      "created_at": "2025-10-07T20:56:01.974Z",
      "description": "ipsum eiusmod",
      "id": "consequat do",
      "modified_at": "2025-10-07T20:56:01.974Z",
      "name": "reprehenderit ut dolore"
    }
  ],
  "pagination": {
    "page_size": 87
  }
}

{
  "items": [
    {
      "created_at": "2025-10-07T20:56:01.974Z",
      "description": "ipsum eiusmod",
      "id": "consequat do",
      "modified_at": "2025-10-07T20:56:01.974Z",
      "name": "reprehenderit ut dolore"
    }
  ],
  "pagination": {
    "page_size": 87
  }
}

Create a new connector.

POST /v1/connectors

Create a new MCP connector. You can customize its visibility, url and auth type.

201

Successful Response

auth_type

string|null

created_at

*date-time

description

*string

id

*string

modified_at

*date-time

name

*string

server

string|null

tools

array<integrations__schemas__api__tool__Tool>|null

Playground

Test the endpoints live

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.create(name="<value>", description="unibody usually despite slushy wherever reward stingy from", server="https://royal-majority.net/")

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.create(name="<value>", description="unibody usually despite slushy wherever reward stingy from", server="https://royal-majority.net/")

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "ipsum eiusmod",
  "name": "consequat do",
  "server": "reprehenderit ut dolore"
}'

curl https://api.mistral.ai/v1/connectors \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "description": "ipsum eiusmod",
  "name": "consequat do",
  "server": "reprehenderit ut dolore"
}'

201

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

Get the auth URL for a connector.

GET /v1/connectors/{connector_id_or_name}/auth_url

Get the OAuth2 authorization URL for a connector to initiate user authentication.

200

Successful Response

auth_url

*string

ttl

*integer

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/auth_url \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/auth_url \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "auth_url": "ipsum eiusmod",
  "ttl": 87
}

{
  "auth_url": "ipsum eiusmod",
  "ttl": 87
}

Call Connector Tool

POST /v1/connectors/{connector_id_or_name}/tools/{tool_name}/call

Call a tool on an MCP connector.

200

Successful Response

AdditionalProperties

map<any>

content

*array<TextContent|ImageContent|AudioContent|ResourceLink|EmbeddedResource>

metadata

ConnectorToolCallMetadata|null

Metadata wrapper for MCP tool call responses.

Nests MCP-specific fields under mcp_meta to avoid collisions with other metadata keys (e.g. tool_call_result) in Harmattan's streaming deltas.

Playground

Test the endpoints live

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.call_tool(tool_name="<value>", connector_id_or_name="<value>")

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.call_tool(tool_name="<value>", connector_id_or_name="<value>")

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools/{tool_name}/call \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools/{tool_name}/call \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "content": [
    {
      "text": "ipsum eiusmod",
      "type": "consequat do"
    }
  ]
}

{
  "content": [
    {
      "text": "ipsum eiusmod",
      "type": "consequat do"
    }
  ]
}

List tools for a connector.

GET /v1/connectors/{connector_id_or_name}/tools

List all tools available for an MCP connector.

200

Response Type

array<ConnectorTool>|array<MCPTool>|array<map<any>>

Successful Response

ConnectorTool

{object}

MCPTool

{object}

Playground

Test the endpoints live

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}/tools \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

[
  {
    "created_at": "2025-10-07T20:56:01.974Z",
    "description": "ipsum eiusmod",
    "execution_config": null,
    "id": "consequat do",
    "modified_at": "2025-10-07T20:56:01.974Z",
    "name": "reprehenderit ut dolore",
    "visibility": "shared_global"
  }
]

[
  {
    "created_at": "2025-10-07T20:56:01.974Z",
    "description": "ipsum eiusmod",
    "execution_config": null,
    "id": "consequat do",
    "modified_at": "2025-10-07T20:56:01.974Z",
    "name": "reprehenderit ut dolore",
    "visibility": "shared_global"
  }
]

Get a connector.

GET /v1/connectors/{connector_id_or_name}#idOrName

Get a connector by its ID or name.

200

Successful Response

auth_type

string|null

created_at

*date-time

description

*string

id

*string

modified_at

*date-time

name

*string

server

string|null

tools

array<integrations__schemas__api__tool__Tool>|null

Playground

Test the endpoints live

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.get(connector_id_or_name="<value>", fetch_customer_data=False, fetch_connection_secrets=False)

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.get(connector_id_or_name="<value>", fetch_customer_data=False, fetch_connection_secrets=False)

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}#idOrName \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

curl https://api.mistral.ai/v1/connectors/{connector_id_or_name}#idOrName \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

Delete a connector.

DELETE /v1/connectors/{connector_id}#id

Delete a connector by its ID.

200

Successful Response

message

*string

Playground

Test the endpoints live

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.delete(connector_id="5c3269fe-6a18-4216-b1fb-b093005874cd")

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.delete(connector_id="5c3269fe-6a18-4216-b1fb-b093005874cd")

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "message": "ipsum eiusmod"
}

{
  "message": "ipsum eiusmod"
}

Update a connector.

PATCH /v1/connectors/{connector_id}#id

Update a connector by its ID.

200

Successful Response

auth_type

string|null

created_at

*date-time

description

*string

id

*string

modified_at

*date-time

name

*string

server

string|null

tools

array<integrations__schemas__api__tool__Tool>|null

Playground

Test the endpoints live

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.update(connector_id="81d30634-113f-4dce-a89e-7786be2d8693")

    # Handle response
    print(res)

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.connectors.update(connector_id="81d30634-113f-4dce-a89e-7786be2d8693")

    # Handle response
    print(res)

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

curl https://api.mistral.ai/v1/connectors/{connector_id}#id \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

{
  "created_at": "2025-10-07T20:56:01.974Z",
  "description": "ipsum eiusmod",
  "id": "consequat do",
  "modified_at": "2025-10-07T20:56:01.974Z",
  "name": "reprehenderit ut dolore"
}

Beta Connectors Endpoints

Examples

GET /v1/connectors

Parameters

query_filters

cursor

page_size

items

pagination

Playground

POST /v1/connectors

Request Body

auth_data

description

headers

icon_url

name

server

system_prompt

visibility

auth_type

created_at

description

id

modified_at

name

server

tools

Playground

GET /v1/connectors/{connector_id_or_name}/auth_url

Parameters

app_return_url

connector_id_or_name

auth_url

ttl

Playground

POST /v1/connectors/{connector_id_or_name}/tools/{tool_name}/call

Parameters

tool_name

credentials_name

connector_id_or_name

Request Body

arguments

AdditionalProperties

content

metadata

Playground

GET /v1/connectors/{connector_id_or_name}/tools

ConnectorTool

MCPTool

Playground

GET /v1/connectors/{connector_id_or_name}#idOrName

Parameters

fetch_customer_data

fetch_connection_secrets

connector_id_or_name

auth_type

created_at

description

id

modified_at

name

server

tools

Playground

DELETE /v1/connectors/{connector_id}#id

Parameters

connector_id

message

Playground

PATCH /v1/connectors/{connector_id}#id

Parameters

connector_id

Request Body

auth_data

connection_config

connection_secrets

description

headers

icon_url