apicheats.dev elevenlabs/llms.txt Raw .md
GET

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

ElevenLabs API

List Mcp Server Tools

Base URL
https://api.elevenlabs.io
Auth
xi-api-key: <ELEVENLABS_API_KEY>
Last verified
2026-09-03 · upstream hash matched
Actions
Agents: curl -H "Accept: text/markdown" this URL
→ 186 tokens · Vary: Accept

Critical gotchas

Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.

Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.

cURL

curl -X GET 'https://api.elevenlabs.io/v1/convai/mcp-servers/mcp-server-id/tools?environment=production' \  -H "xi-api-key: $ELEVENLABS_API_KEY"
Get a free ElevenLabs API key → sponsored

Parameters

Name In Type Required Description
mcp_server_id path string Yes ID of the MCP Server.
environment query string No 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.

Response 200 OK

{
  "success": true,
  "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"
    }
  ]
}