Sign in

v4

OpenAPI 3.1.02026-07-313621,3961.8 MB
Agents Platform

List Mcp Server Tools

Retrieve all tools available for a specific MCP server configuration.

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

Path parameters

mcp_server_idstring required

ID of the MCP Server.

ID of the MCP Server.

Query parameters

environmentstring

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.

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-keystring 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.

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

Successful Response

successboolean required

Indicates if the operation was successful.

error_messagestring nullable

Error message if the operation was not successful.

Example response

{
  "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"
    }
  ]
}