Skip to main content
The list-domains tool retrieves all domains accessible to the authenticated user. This tool is essential for discovering available data domains before making queries with the chat tool.

​
Tool Signature

{
  "name": "list-domains",
  "description": "List domains accessible to the user",
  "inputSchema": {},
  "outputSchema": {
    "domains": "Array<Domain>"
  }
}

​
Parameters

This tool requires no input parameters. Authentication is handled automatically through the MCP session.

​
Response Format

The list-domains tool returns structured content with domain information: 
{
  structuredContent: {
    domains: Array<{
      id: string;
      name: string;
      description: string;
    }>;
  };
}

​
Domain Object

​
id
string
required
Unique identifier for the domain. Use this ID when making chat tool requests.
​
name
string
required
Human-readable name of the domain
​
description
string
required
Description of the domain’s purpose and data content. May be empty for some domains.

​
Usage Example

​
Request

MCP Tool Call
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "list-domains"
  },
  "id": 1
}

​
Response

Response
{
  "jsonrpc": "2.0",
  "result": {
    "structuredContent": {
      "domains": [
        {
          "id": "ET_DOMAIN_aws-usage",
          "name": "AWS Usage Analytics",
          "description": "AWS service usage data across regions and companies"
        },
        {
          "id": "ET_DOMAIN_sales-data",
          "name": "Sales Performance",
          "description": "Sales metrics, revenue data, and customer analytics"
        },
        {
          "id": "ET_DOMAIN_hr-metrics",
          "name": "HR Analytics",
          "description": "Employee data, performance metrics, and organizational insights"
        }
      ]
    }
  },
  "id": 1
}

​
Common Use Cases

Domain Discovery

List all available domains with their IDs before starting a chat

Access Validation

Verify which domains the current user can access

User Onboarding

Help new users understand available data sources

Chat Tool

Use domain IDs from this tool to query specific domains

MCP Server Overview

Learn more about the MCP server architecture