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.

Parametry ścieżki

mcp_server_idstringWymagany

ID of the MCP Server.

Parametry zapytania

environmentstringOpcjonalnyDomyślnie 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.

Odpowiedź

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 objectsOpcjonalny

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

error_messagestringOpcjonalny

Error message if the operation was not successful.

Błędy

422

Tools List Request Unprocessable Entity Error

Parametry ścieżki

Nagłówki

Parametry zapytania

Odpowiedź

Błędy