Clerk MCP Server

Instructions

Implementation Reference

• src/clerk-tools.ts:76-92 (handler)

  The core handler function that executes the delete-user tool logic by calling the Clerk API to permanently delete the user.

  export async function deleteUser(params: { userId: string }) {
    try {
      const { userId } = params;
  
      await clerk.users.deleteUser(userId);
  
      return {
        success: true,
        message: `Usuário ${userId} deletado com sucesso`
      };
    } catch (error: any) {
      return {
        success: false,
        error: error.message || 'Erro ao deletar usuário'
      };
    }
  }

• src/clerk-tools.ts:22-24 (schema)

  Zod schema for input validation of the delete-user tool, requiring a non-empty userId string.

  export const deleteUserSchema = {
    userId: z.string().min(1)
  };

• src/server.ts:64-83 (registration)

  Registration of the 'delete-user' tool in the MCP server (HTTP transport), linking schema, description, and handler wrapper.

  server.registerTool(
    'delete-user',
    {
      title: 'Deletar Usuário',
      description: 'Deleta permanentemente um usuário do Clerk pelo ID. Esta ação é irreversível!',
      inputSchema: deleteUserSchema,
      outputSchema: {
        success: z.boolean(),
        message: z.string().optional(),
        error: z.string().optional()
      }
    },
    async (params) => {
      const result = await deleteUser(params);
      return {
        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
        structuredContent: result
      };
    }
  );

• src/server-stdio.ts:63-82 (registration)

  Registration of the 'delete-user' tool in the MCP server (STDIO transport), identical to HTTP version.

  server.registerTool(
    'delete-user',
    {
      title: 'Deletar Usuário',
      description: 'Deleta permanentemente um usuário do Clerk pelo ID. Esta ação é irreversível!',
      inputSchema: deleteUserSchema,
      outputSchema: {
        success: z.boolean(),
        message: z.string().optional(),
        error: z.string().optional()
      }
    },
    async (params) => {
      const result = await deleteUser(params);
      return {
        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
        structuredContent: result
      };
    }
  );