Create MCP server tool approval

1 curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-approvals \ 2 -H "api-key: xi-api-key" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "tool_name": "foo", 6 "tool_description": "foo" 7 }'

1 { 2 "id": "foo", 3 "config": { 4 "url": "foo", 5 "name": "foo", 6 "approval_policy": "auto_approve_all", 7 "tool_approval_hashes": [ 8 { 9 "tool_name": "foo", 10 "tool_hash": "foo", 11 "approval_policy": "auto_approved" 12 } 13 ], 14 "transport": "SSE", 15 "secret_token": { 16 "secret_id": "foo" 17 }, 18 "request_headers": {}, 19 "description": "" 20 }, 21 "metadata": { 22 "created_at": 42, 23 "owner_user_id": "foo" 24 }, 25 "access_info": { 26 "is_creator": true, 27 "creator_name": "foo", 28 "creator_email": "foo", 29 "role": "admin" 30 }, 31 "dependent_agents": [ 32 { 33 "type": "unknown" 34 } 35 ] 36 }

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_schemaobjectOptional

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

approval_policyenumOptional

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 or null

List of agents that depend on this MCP Server.

Path parameters

Headers

Request

Response

Errors