List available MCP tools

POST 
/api/v1/llm/mcp-list-tools

Returns tools discovered across the selected MCP servers.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Build an assistant that researches the web · Let your assistant answer questions about a customer’s calendar · Answer questions about a website using your own Firecrawl account

Request

Responses

200

Tools listed

List tools exposed by a registered custom MCP server; replace the server ID.

Section ID: DOC-MA-conversations-api-mcpListTools#example-conversations-mcpListTools-request

Request example

{
  "servers": [
    {
      "serverId": "custom:product-tools",
      "enabled": true
    }
  ]
}

Guide request for Inspect the names before setting filters or approvals. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-mcpListTools#example-cookbook-integrations-tools-connections-custom-mcp-servers-04-request

Request example

{
  "servers": [
    {
      "serverId": "custom:firecrawl",
      "enabled": true
    }
  ]
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-MA-conversations-api-mcpListTools#example-conversations-mcpListTools-response

Response example

{
  "tools": [
    {
      "name": "example",
      "description": "example",
      "parametersJsonSchema": {
        "example": "value"
      },
      "metadata": {},
      "serverId": "example_123",
      "tags": [
        "example"
      ],
      "documentationUrl": "https://example.com/resource",
      "outputJsonSchema": {
        "example": "value"
      }
    }
  ],
  "totalCount": 1
}

Document ID: DOC-MA-conversations-api-mcpListTools. Section identities and revisions.

Section	Stable reference
List available MCP tools	DOC-MA-conversations-api-mcpListTools#overview
Request	DOC-MA-conversations-api-mcpListTools#request
Responses	DOC-MA-conversations-api-mcpListTools#responses