Liara MCP Server

Instructions

Implementation Reference

• src/services/mail.ts:48-55 (handler)

  The core handler function that implements the logic to retrieve a specific mail server details from the Liara Mail API using the provided mail server ID.

  export async function getMailServer(
      client: LiaraClient,
      mailId: string
  ): Promise<MailServer> {
      validateRequired(mailId, 'Mail server ID');
      const mailClient = createMailClient(client);
      return await mailClient.get<MailServer>(`/v1/mails/${mailId}`);
  }

• src/api/types.ts:287-293 (schema)

  Type definition for the MailServer object, used as the return type for the getMailServer function.

  export interface MailServer {
      _id: string;
      name: string;
      mode: 'DEV' | 'LIVE';
      status: 'ACTIVE' | 'INACTIVE';
      createdAt: string;
  }

• src/services/mail.ts:13-30 (helper)

  Helper function that creates a specialized LiaraClient instance configured for the Mail service API endpoint.

  function createMailClient(client: LiaraClient): LiaraClient {
      // Access the internal client to get the API token
      const internalClient = (client as any).client;
      const apiToken = internalClient?.defaults?.headers?.Authorization?.replace('Bearer ', '') || 
                       process.env.LIARA_API_TOKEN;
      const teamId = (client as any).teamId || process.env.LIARA_TEAM_ID;
  
      if (!apiToken) {
          throw new Error('API token is required for Mail operations');
      }
  
      // Create new client with Mail service base URL
      return new LiaraClient({
          apiToken,
          teamId,
          baseURL: 'https://mail-service.liara.ir/api',
      });
  }

• src/utils/errors.ts:54-58 (helper)

  Validation helper used in the handler to ensure mailId is provided.

  export function validateRequired(value: any, fieldName: string): void {
      if (value === undefined || value === null || value === '') {
          throw new LiaraMcpError(`${fieldName} is required`);
      }
  }