MCP 서버 도구 목록

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"
}

특정 MCP 서버 구성에서 사용할 수 있는 모든 도구를 조회합니다.

경로 매개변수

mcp_server_idstring필수

MCP 서버 ID입니다.

쿼리 매개변수

environmentstring선택 사항기본값 production

MCP 서버 URL, 헤더 또는 인증 연결에서 환경 변수를 참조할 때 값을 사용할 환경입니다. 대화가 실행되는 환경을 반영하며, 기본값은 production입니다.

응답

성공 응답

successboolean

작업이 성공했는지 나타냅니다.

toolslist of objects

MCP 서버에서 사용할 수 있는 도구 목록입니다.

tool_approval_statuseslist of objects선택 사항

현재 검색된 도구의 파생 승인 상태입니다. 도구별 승인을 사용하는 영구 MCP 서버에 대해서만 채워지며, 그 외에는 비어 있습니다.

error_messagestring선택 사항

작업이 성공하지 않은 경우의 오류 메시지입니다.

오류

422

Tools List Request Unprocessable Entity Error