Lightdash MCP Server

Instructions

Implementation Reference

• src/mcp.ts:470-490 (handler)

  The handler case for 'lightdash_get_user_attributes' that fetches organization user attributes from the Lightdash API endpoint '/api/v1/org/attributes' and returns the JSON-formatted results.

  case 'lightdash_get_user_attributes': {
    const { data, error } = await lightdashClient.GET(
      '/api/v1/org/attributes',
      {}
    );
    if (error) {
      throw new Error(
        `Lightdash API error: ${error.error.name}, ${
          error.error.message ?? 'no message'
        }`
      );
    }
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(data.results, null, 2),
        },
      ],
    };
  }

• src/schemas.ts:106-107 (schema)

  Zod schema defining the input for the tool, which requires no parameters (empty object).

  export const GetUserAttributesRequestSchema = z.object({});

• src/mcp.ts:109-113 (registration)

  Registration of the tool in the ListTools response, specifying name, description, and input schema.

  {
    name: 'lightdash_get_user_attributes',
    description: 'Get organization user attributes',
    inputSchema: zodToJsonSchema(GetUserAttributesRequestSchema),
  },