Agents Platform

List Mcp Server Tools

Changed on

Retrieve all tools available for a specific MCP server configuration.

get/v1/convai/mcp-servers/{mcp_server_id}/tools

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/convai/mcp-servers/{mcp_server_id}/tools
  • Auth
    none declared

Path parameters

mcp_server_idstring required

ID of the MCP Server.

Query parameters

environmentstring

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.

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

successboolean required

Indicates if the operation was successful.

error_messagestring nullable

Error message if the operation was not successful.

Example response

{
  "success": true,
  "tool_approval_statuses": [],
  "tools": [
    {
      "description": "Gets current weather conditions for a location.",
      "inputSchema": {
        "properties": {
          "latitude": {
            "description": "Latitude",
            "type": "string"
          },
          "longitude": {
            "description": "Longitude",
            "type": "string"
          }
        },
        "required": [
          "latitude",
          "longitude"
        ],
        "type": "object"
      },
      "name": "weather_by_zapier_get_current"
    },
    {
      "description": "Description of tool2",
      "inputSchema": {
        "properties": {},
        "type": "object"
      },
      "name": "tool2"
    }
  ]
}

Changes

  • 6fb9be1a19f5Revision changes
    • info

      added the optional property to the response with the status

  • b1797a1d5e80Revision changes
    • info

      added the optional property ///// to the response with the status