REretellai

GET /get-mcp-tools/{agent_id}

Changed on

Get MCP tools for a specific agent

Request

  • Base URL
    https://api.retellai.com
  • Auth
    HTTP bearer

Path parameters

agent_idstring required
Example:oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD

Unique id of the agent to get MCP tools for.

Query parameters

string
OR
integer
Example:latest_published

Optional version of the agent to use for this request. Default to latest version.

mcp_idstring required
Example:mcp-server-1

The ID of the MCP server to get tools from.

component_idstring
Example:component-123

The ID of the component if the MCP server is configured under a component.

Response

Successfully retrieved MCP tools.

namestring required

Name of the MCP tool.

descriptionstring required

Description of what the MCP tool does.

inputSchemaobject required

JSON schema defining the input parameters for the tool.

Example response

[
  {
    "name": "search_files",
    "description": "Search for files in the filesystem",
    "inputSchema": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Search query"
        }
      },
      "required": [
        "query"
      ]
    }
  }
]

Changes

  • 7dd16ddf69d8Revision changes
    • info

      query request parameter version list-of-types was widened by adding types string

    • info

      for the query request parameter version, the type was generalized from integer to no type

  • 8fbf8c54a142Revision changes
    • breaking

      for the path request parameter agent_id, the minLength was increased from 0 to 1