lokalise-mcp/dist/domains/teamusers/teamusers.tool.js

The Lokalise MCP Server brings Lokalise's localization power to Claude and AI assistants—manage projects, keys, and translations by chat.

import { formatErrorForMcpTool } from "../../shared/utils/error.util.js";
import { Logger } from "../../shared/utils/logger.util.js";
import teamusersController from "./teamusers.controller.js";
import { DeleteTeamusersToolArgs, GetTeamusersToolArgs, ListTeamusersToolArgs, UpdateTeamusersToolArgs, } from "./teamusers.types.js";
/**
 * @function handleListTeamusers
 * @description MCP Tool handler to retrieve a list of teamusers from a Lokalise project.
 *              It calls the teamusersController to fetch the data and formats the response for the MCP.
 *
 * @param {ListTeamuserssToolArgsType} args - Arguments provided to the tool.
 * @returns {Promise<{ content: Array<{ type: 'text', text: string }> }>} Formatted response for the MCP.
 * @throws {McpError} Formatted error if the controller or service layer encounters an issue.
 */
async function handleListTeamusers(args) {
    const methodLogger = Logger.forContext("teamusers.tool.ts", "handleListTeamusers");
    methodLogger.debug(`Getting Lokalise teamusers list (limit: ${args.limit || "default"}, page: ${args.page || "1"})...`, args);
    try {
        const result = await teamusersController.listTeamusers(args);
        methodLogger.debug("Got the response from the controller", result);
        return {
            content: [
                {
                    type: "text",
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error("Tool failed", {
            error: error.message,
            args,
        });
        return formatErrorForMcpTool(error);
    }
}
/**
 * @function handleGetTeamusers
 * @description MCP Tool handler to retrieve details of a specific teamusers.
 *
 * @param {GetTeamusersToolArgsType} args - Arguments provided to the tool.
 * @returns {Promise<{ content: Array<{ type: 'text', text: string }> }>} Formatted response for the MCP.
 * @throws {McpError} Formatted error if the controller or service layer encounters an issue.
 */
async function handleGetTeamusers(args) {
    const methodLogger = Logger.forContext("teamusers.tool.ts", "handleGetTeamusers");
    methodLogger.debug("Getting teamusers details...", args);
    try {
        const result = await teamusersController.getTeamusers(args);
        methodLogger.debug("Got the response from the controller", result);
        return {
            content: [
                {
                    type: "text",
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error("Tool failed", {
            error: error.message,
            args,
        });
        return formatErrorForMcpTool(error);
    }
}
/**
 * @function handleUpdateTeamusers
 * @description MCP Tool handler to update a teamusers's properties.
 *
 * @param {UpdateTeamusersToolArgsType} args - Arguments provided to the tool.
 * @returns {Promise<{ content: Array<{ type: 'text', text: string }> }>} Formatted response for the MCP.
 * @throws {McpError} Formatted error if the controller or service layer encounters an issue.
 */
async function handleUpdateTeamusers(args) {
    const methodLogger = Logger.forContext("teamusers.tool.ts", "handleUpdateTeamusers");
    methodLogger.debug("Updating teamusers...", args);
    try {
        const result = await teamusersController.updateTeamusers(args);
        methodLogger.debug("Got the response from the controller", result);
        return {
            content: [
                {
                    type: "text",
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error("Tool failed", {
            error: error.message,
            args,
        });
        return formatErrorForMcpTool(error);
    }
}
/**
 * @function handleDeleteTeamusers
 * @description MCP Tool handler to remove a teamusers from a project.
 *
 * @param {DeleteTeamusersToolArgsType} args - Arguments provided to the tool.
 * @returns {Promise<{ content: Array<{ type: 'text', text: string }> }>} Formatted response for the MCP.
 * @throws {McpError} Formatted error if the controller or service layer encounters an issue.
 */
async function handleDeleteTeamusers(args) {
    const methodLogger = Logger.forContext("teamusers.tool.ts", "handleDeleteTeamusers");
    methodLogger.debug("Removing teamusers...", args);
    try {
        const result = await teamusersController.deleteTeamusers(args);
        methodLogger.debug("Got the response from the controller", result);
        return {
            content: [
                {
                    type: "text",
                    text: result.content,
                },
            ],
        };
    }
    catch (error) {
        methodLogger.error("Tool failed", {
            error: error.message,
            args,
        });
        return formatErrorForMcpTool(error);
    }
}
/**
 * @function registerTools
 * @description Registers all teamusers-related tools with the MCP server.
 *              This function binds the tool names to their handler functions and schemas.
 *
 * @param {McpServer} server - The MCP server instance where tools will be registered.
 */
function registerTools(server) {
    const methodLogger = Logger.forContext("teamusers.tool.ts", "registerTools");
    methodLogger.info("Registering teamusers MCP tools");
    server.tool("lokalise_list_team_users", "Lists all users in a Lokalise team with pagination support. Required: teamId. Optional: limit (100), page. Use to audit team composition, check access levels, or prepare team changes. Returns: Users with roles, permissions, and activity status.", ListTeamusersToolArgs.shape, handleListTeamusers);
    server.tool("lokalise_get_team_user", "Gets detailed information about a specific user in a team. Required: teamId, userId. Use to verify user permissions, check role assignments, or investigate access issues. Returns: Complete user profile with all team permissions and administrative rights.", GetTeamusersToolArgs.shape, handleGetTeamusers);
    server.tool("lokalise_update_team_user", "Updates a team user's role (owner, admin, member, or biller). Required: teamId, userId, role. Use to manage permissions, promote/demote, or adjust access levels. Returns: Updated user profile with new role and permissions.", UpdateTeamusersToolArgs.shape, handleUpdateTeamusers);
    server.tool("lokalise_delete_team_user", "Removes a user from a Lokalise team. Required: teamId, userId. Use to remove members, clean up permissions, or manage team structure. Returns: Success message with user details.", DeleteTeamusersToolArgs.shape, handleDeleteTeamusers);
    methodLogger.info("Teamusers MCP tools registered successfully");
}
// Export the domain tool implementation
const teamusersTool = {
    registerTools,
    getMeta() {
        return {
            name: "teamusers",
            description: "Team users management for Lokalise teams",
            version: "1.0.0",
            toolsCount: 4,
        };
    },
};
export default teamusersTool;