List MCP server tools

GET

/v1/convai/mcp-servers/:mcp_server_id/tools

GET

/v1/convai/mcp-servers/:mcp_server_id/tools

curl -G https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tools \
     -d environment=environment

{
  "success": true,
  "tools": [
    {
      "name": "weather_by_zapier_get_current",
      "inputSchema": {
        "properties": {
          "latitude": {
            "description": "Latitude",
            "type": "string"
          },
          "longitude": {
            "description": "Longitude",
            "type": "string"
          }
        },
        "required": [
          "latitude",
          "longitude"
        ],
        "type": "object"
      },
      "title": "title",
      "description": "Gets current weather conditions for a location.",
      "outputSchema": {
        "key": "value"
      },
      "icons": [
        {
          "src": "src"
        }
      ],
      "_meta": {
        "key": "value"
      }
    },
    {
      "name": "tool2",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "title": "title",
      "description": "Description of tool2",
      "outputSchema": {
        "key": "value"
      },
      "icons": [
        {
          "src": "src"
        }
      ],
      "_meta": {
        "key": "value"
      }
    }
  ],
  "tool_approval_statuses": [
    {
      "tool_id": "tool_id",
      "state": "up_to_date",
      "approval_policy": "auto_approved"
    }
  ],
  "error_message": "error_message"
}

Retrieve all tools available for a specific MCP server configuration.

Paramètres de chemin

mcp_server_idstringRequis

ID of the MCP Server.

Paramètres de requête

environmentstringOptionnelPar défaut production

Environment whose values are used when the MCP server URL, headers, or auth connection reference environment variables. Mirrors the environment a conversation would run in; defaults to production.

Réponse

Successful Response

successboolean

Indicates if the operation was successful.

toolslist of objects

A list of tools available on the MCP server.

tool_approval_statuseslist of objectsOptionnel

Derived approval states for currently discovered tools. Populated only for persisted MCP servers using per-tool approval; otherwise empty.

error_messagestringOptionnel

Error message if the operation was not successful.

Erreurs

422

Tools List Request Unprocessable Entity Error

Paramètres de chemin

En-têtes

Paramètres de requête

Réponse

Erreurs