---
title: "List Mcp Server Tools"
method: GET
path: "/v1/convai/mcp-servers/{mcp_server_id}/tools"
tags: ["Agents Platform"]
---

# List Mcp Server Tools

`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

Retrieve all tools available for a specific MCP server configuration.

## Path parameters

- `mcp_server_id` string, required: ID of the MCP Server.

## Query parameters

- `environment` string: 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-key` string, 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 `200`

Successful Response

- ListMCPToolsResponseModel: Response model for testing tools available on an MCP server.
  - `success` boolean, required: Indicates if the operation was successful.
  - `tools` Tool[], required: A list of tools available on the MCP server.
    - `name` string, required
    - `title` string, nullable
    - `description` string, nullable
    - `inputSchema` object, required
    - `execution` ToolExecution: Execution-related properties for a tool (2025-11-25 only).
      - `taskSupport` 'forbidden' | 'optional' | 'required', nullable
    - `outputSchema` object, nullable
    - `icons` Icon[], nullable
      - `src` string, required
      - `mimeType` string, nullable
      - `sizes` string[], nullable
      - `theme` 'light' | 'dark', nullable
    - `annotations` ToolAnnotations: Additional properties describing a Tool to clients. NOTE: all properties in ToolAnnotations are **hints**. They are not guaranteed to provide a faithful description of tool behavior (including descriptive properties like `title`). Clients should never make tool use decisions based on ToolAnnotations received from untrusted servers.
      - `title` string, nullable
      - `readOnlyHint` boolean, nullable
      - `destructiveHint` boolean, nullable
      - `idempotentHint` boolean, nullable
      - `openWorldHint` boolean, nullable
    - `_meta` object, nullable
  - `tool_approval_statuses` MCPToolApprovalStatus[]: Derived approval states for currently discovered tools. Populated only for persisted MCP servers using per-tool approval; otherwise empty.
    - `tool_id` string, required: Canonical MCP tool identifier in the form mcp:<server_id>:<tool_name>
    - `state` 'up_to_date' | 'needs_review' | 'not_approved', required: Whether a discovered MCP tool has an approval and whether it still matches.
    - `approval_policy` 'auto_approved' | 'requires_approval': Defines the tool-level approval policy.
    - `approved_definition` MCPApprovedToolDefinition: Snapshot of the MCP tool definition that was approved.
      - `description` string: The MCP server-provided tool description at approval time
      - `input_schema` object: The MCP server-provided JSON input schema at approval time
  - `error_message` string, nullable: Error message if the operation was not successful.

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-22** `6fb9be1a19f5`: 1 info
  - added the optional property `tool_approval_statuses` to the response with the `200` status
- **2026-09-04** `b1797a1d5e80`: 1 info
  - added the optional property `tools/items/icons/anyOf[subschema #1]/items/theme` to the response with the `200` status
- **2026-07-13** `009bd651509a`: 1 info
  - added the new optional `query` request parameter `environment`
- **2026-06-08** `37fac3c5a2d7`: 2 info
  - added the optional property `tools/items/execution` to the response with the `200` status
  - added the optional property `tools/items/icons` to the response with the `200` status
- **2026-02-08** `5b595807512c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/mcp-servers/:mcp_server_id/tools/get.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/d04f5e77c40a?raw)