---
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`

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
    - `outputSchema` object, nullable
    - `icons` Icon[], nullable
      - `src` string, required
      - `mimeType` string, nullable
      - `sizes` string[], 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
    - `execution` ToolExecution — Execution-related properties for a tool.
      - `taskSupport` 'forbidden' | 'optional' | 'required', nullable
  - `error_message` string, nullable — Error message if the operation was not successful.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/3b2cee2701a3/schema)