Create MCP server tool approval

curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-approvals \
     -H "Content-Type: application/json" \
     -d '{
  "tool_name": "ImageEnhancer",
  "tool_description": "Enhances image quality using advanced AI algorithms."
}'

{
  "id": "mcp-123e4567-e89b-12d3-a456-426614174000",
  "config": {
    "url": "https://mcpserver.example.com/api/v1/tools",
    "name": "Main MCP Server",
    "approval_policy": "require_approval_per_tool",
    "tool_approval_hashes": [
      {
        "tool_name": "ImageEnhancer",
        "tool_hash": "a3f5c9d8e7b6f4a1c2d3e4f56789abcd1234567890abcdef1234567890abcdef",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret-7890abcdef123456"
    },
    "request_headers": {},
    "auth_connection": {
      "auth_connection_id": "authconn-4567def890ab1234"
    },
    "description": "Primary MCP server handling AI tool integrations.",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "ImageEnhancer",
        "pre_tool_speech": "force",
        "disable_interruptions": true,
        "tool_call_sound": "elevator2",
        "tool_call_sound_behavior": "always",
        "execution_mode": "post_tool_speech",
        "response_timeout_secs": 60,
        "assignments": [
          {
            "dynamic_variable": "enhanced_image_url",
            "value_path": "result.image_url",
            "source": "response",
            "sanitize": true,
            "preserve_native_type": false
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "{\"status\":\"success\",\"image_url\":\"https://mocked.example.com/test_enhanced.jpg\"}",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "exact",
                  "description": "Trigger mock when input image is test.jpg"
                },
                "path": "input.image_name"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1685996400,
    "owner_user_id": "user-5678abcd1234efgh"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1686000000,
      "id": "agent-1234abcd5678efgh",
      "name": "Image Processing Agent",
      "referenced_resource_ids": [
        "agent-9876fedcba4321"
      ]
    }
  ]
}

curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-approvals \
     -H "Content-Type: application/json" \
     -d '{
  "tool_name": "ImageEnhancer",
  "tool_description": "Enhances image quality using advanced AI algorithms."
}'

{
  "id": "mcp-123e4567-e89b-12d3-a456-426614174000",
  "config": {
    "url": "https://mcpserver.example.com/api/v1/tools",
    "name": "Main MCP Server",
    "approval_policy": "require_approval_per_tool",
    "tool_approval_hashes": [
      {
        "tool_name": "ImageEnhancer",
        "tool_hash": "a3f5c9d8e7b6f4a1c2d3e4f56789abcd1234567890abcdef1234567890abcdef",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret-7890abcdef123456"
    },
    "request_headers": {},
    "auth_connection": {
      "auth_connection_id": "authconn-4567def890ab1234"
    },
    "description": "Primary MCP server handling AI tool integrations.",
    "pre_tool_speech": "auto",
    "disable_interruptions": false,
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "tool_name": "ImageEnhancer",
        "pre_tool_speech": "force",
        "disable_interruptions": true,
        "tool_call_sound": "elevator2",
        "tool_call_sound_behavior": "always",
        "execution_mode": "post_tool_speech",
        "response_timeout_secs": 60,
        "assignments": [
          {
            "dynamic_variable": "enhanced_image_url",
            "value_path": "result.image_url",
            "source": "response",
            "sanitize": true,
            "preserve_native_type": false
          }
        ],
        "input_overrides": {},
        "response_mocks": [
          {
            "mock_result": "{\"status\":\"success\",\"image_url\":\"https://mocked.example.com/test_enhanced.jpg\"}",
            "parameter_conditions": [
              {
                "eval": {
                  "type": "exact",
                  "description": "Trigger mock when input image is test.jpg"
                },
                "path": "input.image_name"
              }
            ]
          }
        ],
        "force_pre_tool_speech": true
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false
  },
  "metadata": {
    "created_at": 1685996400,
    "owner_user_id": "user-5678abcd1234efgh"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1686000000,
      "id": "agent-1234abcd5678efgh",
      "name": "Image Processing Agent",
      "referenced_resource_ids": [
        "agent-9876fedcba4321"
      ]
    }
  ]
}

Add approval for a specific MCP tool when using per-tool approval mode.

Path parameters

mcp_server_idstringRequired

ID of the MCP Server.

Request

This endpoint expects an object.

tool_namestringRequired

The name of the MCP tool

tool_descriptionstringRequired

The description of the MCP tool

input_schemamap from strings to anyOptional

The input schema of the MCP tool (the schema defined on the MCP server before ElevenLabs does any extra processing)

approval_policyenumOptionalDefaults to requires_approval

The tool-level approval policy

Allowed values:

Response

Successful Response

idstring

configobject

metadataobject

The metadata of the MCP Server

access_infoobject or null

The access information of the MCP Server

dependent_agentslist of objects

List of agents that depend on this MCP Server.

Errors

422

Unprocessable Entity Error

Create MCP server tool approval

Path parameters

Headers

Request

Response

Errors

Path parameters

Headers

Request

Response

Errors

$	curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-approvals \
>	-H "Content-Type: application/json" \
>	-d '{
>	"tool_name": "ImageEnhancer",
>	"tool_description": "Enhances image quality using advanced AI algorithms."
>	}'

1	{
2	"id": "mcp-123e4567-e89b-12d3-a456-426614174000",
3	"config": {
4	"url": "https://mcpserver.example.com/api/v1/tools",
5	"name": "Main MCP Server",
6	"approval_policy": "require_approval_per_tool",
7	"tool_approval_hashes": [
8	{
9	"tool_name": "ImageEnhancer",
10	"tool_hash": "a3f5c9d8e7b6f4a1c2d3e4f56789abcd1234567890abcdef1234567890abcdef",
11	"approval_policy": "requires_approval"
12	}
13	],
14	"transport": "SSE",
15	"secret_token": {
16	"secret_id": "secret-7890abcdef123456"
17	},
18	"request_headers": {},
19	"auth_connection": {
20	"auth_connection_id": "authconn-4567def890ab1234"
21	},
22	"description": "Primary MCP server handling AI tool integrations.",
23	"pre_tool_speech": "auto",
24	"disable_interruptions": false,
25	"tool_call_sound": "typing",
26	"tool_call_sound_behavior": "auto",
27	"execution_mode": "immediate",
28	"response_timeout_secs": 30,
29	"tool_config_overrides": [
30	{
31	"tool_name": "ImageEnhancer",
32	"pre_tool_speech": "force",
33	"disable_interruptions": true,
34	"tool_call_sound": "elevator2",
35	"tool_call_sound_behavior": "always",
36	"execution_mode": "post_tool_speech",
37	"response_timeout_secs": 60,
38	"assignments": [
39	{
40	"dynamic_variable": "enhanced_image_url",
41	"value_path": "result.image_url",
42	"source": "response",
43	"sanitize": true,
44	"preserve_native_type": false
45	}
46	],
47	"input_overrides": {},
48	"response_mocks": [
49	{
50	"mock_result": "{\"status\":\"success\",\"image_url\":\"https://mocked.example.com/test_enhanced.jpg\"}",
51	"parameter_conditions": [
52	{
53	"eval": {
54	"type": "exact",
55	"description": "Trigger mock when input image is test.jpg"
56	},
57	"path": "input.image_name"
58	}
59	]
60	}
61	],
62	"force_pre_tool_speech": true
63	}
64	],
65	"disable_compression": false,
66	"force_pre_tool_speech": false
67	},
68	"metadata": {
69	"created_at": 1685996400,
70	"owner_user_id": "user-5678abcd1234efgh"
71	},
72	"access_info": {
73	"is_creator": true,
74	"creator_name": "John Doe",
75	"creator_email": "john.doe@example.com",
76	"role": "admin",
77	"access_source": "creator"
78	},
79	"dependent_agents": [
80	{
81	"type": "available",
82	"access_level": "admin",
83	"created_at_unix_secs": 1686000000,
84	"id": "agent-1234abcd5678efgh",
85	"name": "Image Processing Agent",
86	"referenced_resource_ids": [
87	"agent-9876fedcba4321"
88	]
89	}
90	]
91	}